MySQLHelper类使用说明

目录

MySQLHelper类使用说明    1

目录    2

修订历史纪录    3

1 公用方法    4

1.1 GetMaxID (string FieldName,string TableName)    4

1.2 Exists(string strSql, params SqlParameter[]TableName)    4

2 执行简单SQL语句    4

2.1 ExecuteSql(string SQLString)    4

2.2 ExecuteSqlTran(ArrayList SQLStringList)    4

2.3 ExecuteSql(string SQLString,string content)    4

2.4 ExecuteSqlInsertImg(string strSQL,byte[] fs)    5

2.5 GetSingle(string SQLString)    5

2.6 ExecuteReader(string strSQL)    5

2.7 Query(string SQLString)    5

3 执行带参数的SQL语句    5

3.1 ExecuteSql(string SQLString,params SqlParameter[] cmdParms)    5

3.2 ExecuteSqlTran(Hashtable SQLStringList)    5

3.3 GetSingle(string SQLString,params SqlParameter[] cmdParms)    6

3.4 ExecuteReader(string SQLString,params SqlParameter[] cmdParms)    6

3.5 Query(string SQLString,params SqlParameter[] cmdParms)    6

3.6 PrepareCommand(SqlCommand cmd,SqlConnection conn,SqlTransaction trans, string cmdText, SqlParameter[] cmdParms)    7

4 存储过程操作    7

4.1 RunProcedure(string storedProcName, IDataParameter[] parameters )    7

4.2 RunProcedure(string storedProcName, IDataParameter[] parameters, string tableName )    7

4.3 BuildQueryCommand(SqlConnection connection,string storedProcName, IDataParameter[] parameters)    7

4.4 RunProcedure(string storedProcName, IDataParameter[] parameters, out int rowsAffected )    8

4.5 BuildIntCommand(SqlConnection connection,string storedProcName, IDataParameter[] parameters)    8

 

1 公用方法

1.1 GetMaxID (string FieldName,string TableName)

功能：获取一张表中某一列的最大值

参数：FieldName 列名，TableName 表名

返回值：返回最大值+1

1.2 Exists(string strSql, params SqlParameter[]TableName)

功能：判断SQL语句是否执行，执行返回true，否则返回false

参数：strSql SQL语句，

TableName 参数数组

返回值：bool类型，true表示执行、false表未执行

2 执行简单SQL语句

2.1 ExecuteSql(string SQLString)

功能：执行没有参数的SQL语句，返回影响行数

参数：SQLString SQL语句

返回值：int型，返回影响行数

2.2 ExecuteSqlTran(ArrayList SQLStringList)

功能：执行多条SQL语句，实现数据库事务。防止执行过程中出现意外造成有的SQL语句执行而有的SQL语句未执行

        例如 更改用户表数据时同时要更改用户详细信息表数据，一旦用户表数据更改完成但用户详细信息表数据更改失败。则进行数据滚回操作，回到两个表都未更新的状态

参数：ArrayList类型SQL语句组

返回值：void

2.3 ExecuteSql(string SQLString,string content)

功能：执行一个带参数的SQL语句

参数：SQLString 带参数的SQL语句，

content 参数值

返回值：int型，返回影响行数

2.4 ExecuteSqlInsertImg(string strSQL,byte[] fs)

功能：向数据库中插入图片，图便以二进制形式存储

参数：strSQL 带参数的SQL语句，

byte[] fs 二进制形式的图片

返回值：int型，返回影响行数

2.5 GetSingle(string SQLString)

功能：返回执行聚合函数（count()、max()……之类）后的返回值，

参数：SQLString SQL语句

返回值：返回值为object类型，使用时应转会为相应类型

2.6 ExecuteReader(string strSQL)

功能：查询执行select语句并以SqlDataReader形式返回，多用于返回单条记录

参数：strSQL 查询SQL语句

返回值：SqlDataReader类型

2.7 Query(string SQLString)

功能：查询执行select语句并以DataSet形式返回，多用于返回多条记录

参数：strSQL 查询SQL语句

返回值：DataSet类型

3 执行带参数的SQL语句

3.1 ExecuteSql(string SQLString,params SqlParameter[] cmdParms)

功能：执行带参数的SQL语句

参数：SQLString 带参数的SQL语句，

cmdParms 参数数组

返回值：int型，返回影响行数

3.2 ExecuteSqlTran(Hashtable SQLStringList)

功能：执行多条带参数的SQL语句，实现数据库事务。防止执行过程中出现意外造成有的SQL语句执行而有的SQL语句未执行

例如 更改用户表数据时同时要更改用户详细信息表数据，一旦用户表数据更改完成但用户详细信息表数据更改失败。则进行数据滚回操作，回到两个表都未更新的状态

 

参数：SQLStringList 这是一个SQL语句的Hash表，表中key为带参数的SQL，value为该语句对应的参数

 

返回值：void

3.3 GetSingle(string SQLString,params SqlParameter[] cmdParms)

功能：返回执行聚合函数（count()、max()……之类）后的返回值，

参数：SQLString SQL语句，

cmdParms 该语句对应的参数数组

返回值：返回值为object类型，使用时应转会为相应类型

3.4 ExecuteReader(string SQLString,params SqlParameter[] cmdParms)

功能：查询执行带参数的select语句并以SqlDataReader形式返回，多用于返回单条记录

参数：strSQL 查询SQL语句，

cmdParms 该语句对应的参数数组

返回值：SqlDataReader

3.5 Query(string SQLString,params SqlParameter[] cmdParms)

功能：查询执行带参数的select语句并以DataSet形式返回，多用于返回多条记录

参数：strSQL 查询SQL语句，

cmdParms 该语句对应的参数数组

返回值：DataSet

3.6 PrepareCommand(SqlCommand cmd,SqlConnection conn,SqlTransaction trans, string cmdText, SqlParameter[] cmdParms)

功能：把参数添加到带参数的SQL语句中

参数：SqlCommand cmd 数据库操作命令，

SqlConnection conn 数据库连接，

SqlTransaction trans 数据库事务 当不用事务时赋null，

string cmdText SQL语句，

SqlParameter[] cmdParms 该语句对应的参数

返回值：void

4 存储过程操作

4.1 RunProcedure(string storedProcName, IDataParameter[] parameters )

功能：执行功能为查询（select）的存储过程，返回SqlDataReader

参数：storedProcName 存储过程名

     parameters 存储过程参数

返回值：以SqlDataReader形式返回，多用于返回单条记录

4.2 RunProcedure(string storedProcName, IDataParameter[] parameters, string tableName )

功能：执行功能为查询（select）的存储过程，返回DataSet

参数：storedProcName 存储过程名

     parameters 存储过程参数

tableName DataSet结果中的表名（一个DataSet中可以有多个表）

返回值：以DataSet形式返回，多用于返回多条记录

 

4.3 BuildQueryCommand(SqlConnection connection,string storedProcName, IDataParameter[] parameters)

功能：构建SqlCommand对象，把存储过程参数加到SQL语句中

参数：connection 数据库连接

     storedProcName 存储过程名

     parameters 储过程参数

返回值：SqlCommand对象

4.4 RunProcedure(string storedProcName, IDataParameter[] parameters, out int rowsAffected )

功能：用于得到存储过程的返回值，返回值的参数为ReturnValue

参数：storedProcName 存储过程名

     Parameters 存储过程参数

     rowsAffected 引用参数 从外部传入函数，记录执行存储过程影响的行数

返回值：int型，返回存储过程的返回值

4.5 BuildIntCommand(SqlConnection connection,string storedProcName, IDataParameter[] parameters)

功能：创建SqlCommand对象，把存储过程返回值的参数传入

参数：connection 数据库连接

     storedProcName 存储过程名

     parameters 存储过程参数

返回值： SqlCommand