| 自己编写的数据访问类（C#）--第三篇 |
| 作者/天才 时间/2006-1-10 17:11:00 类别/开发技术 查看/ |
 发表评论 以论坛方式查看 |
| 标签：.Net联盟 |
作者：黄润成 （接上） DbService类定义的静态方法及其说明如下列表所示： /// <summary> /// 后台线程执行的函数，定时检测DbServicePool中的对象的数据库连接是否已达指定的时间，如果是则关闭该对象的数据库连接。 /// </summary> private static void Back_Proc() /// <summary> /// 从数据库连接对象池中获取数据库连接对象，如果池中没有可用的对象则创建一个。 /// </summary> /// <returns>实现了 IDbService 接口的数据库连接对象。</returns> public static IDbService GetDbService() /// <summary> /// 创建 并 返回 数据服务对象，并指定数据服务对象使用的数据库连接串。 /// </summary> /// <param name="ConnString">数据库连接串。</param> /// <returns>返回 创建的数据服务对象。</returns> public static IDbService GetDbService(string ConnString) /// <summary> /// 释放数据服务对象引用，并将其放回对象池中以备其他用户引用。同时，作为 DataReaderWrapper 类的 OnClose 事件委托， /// 在 DataReaderWrapper 类实例调用 Close() 方法时将引用的数据库连接对象释放并放回池中。 /// </summary> /// <param name="ADbService">指定要释放的数据服务对象。</param> public static void ReleaseDbService(IDbService ADbService) /// <summary> /// 清除数据服务对象池中的所有对象。当程序需要释放池占用的资源时调用。 /// </summary> public static void ReleaseDbPool() /// <summary> /// 创建参数对象。 /// </summary> /// <param name="ParamName">参数名称。</param> /// <param name="ParamType">参数类型。</param> /// <returns>返加 创建的参数对象。</returns> public static IDbDataParameter CreateParameter(string ParamName, DbType ParamType) /// <summary> /// 创建参数对象。 /// </summary> /// <param name="ParamName">参数名称。</param> /// <param name="ParamType">参数类型。</param> /// <param name="ParamValue">参数值。</param> /// <returns>返加 创建的参数对象。</returns> public static IDbDataParameter CreateParameter(string ParamName, DbType ParamType, object ParamValue) /// <summary> /// 创建参数对象。 /// </summary> /// <param name="ParamName">参数名称。</param> /// <param name="ParamType">参数类型。</param> /// <param name="ParamValue">参数值。</param> /// <param name="ParamDirection">参数的传递方向（Input; Output; InputOutput; ReturnValue）</param> /// <returns>返加 创建的参数对象。</returns> public static IDbDataParameter CreateParameter(string ParamName, DbType ParamType, object ParamValue, ParameterDirection ParamDirection) /// <summary> /// 创建 DbParams 对象，根据传入的参数名称数组、参数类型数组返回一个包含 0 个或多个参数对象（IDbDataParameter）的 DbParams 对象。 /// DbParams 对象用于设置执行 SQL 语句所需要的参数。 /// </summary> /// <param name="ParamNames">字符串类型的数组，表示多个参数名称，例如：new string[]{"@Param1", "@Param2",..."@ParamN"}</param> /// <param name="ParamTypes">DbType 类型的数组，指定对应前面的各个参数的类型。</param> /// <returns>返回 一个包含 0 个或多个参数对象（IDbDataParameter）的 DbParams 对象。</returns> public static DbParams CreateDbParams(string[] ParamNames, DbType[] ParamTypes) /// <summary> /// 创建 DbParams 对象，根据传入的参数名称数组、参数类型数组、参数值数组返回一个包含 0 个或多个参数对象（IDbDataParameter）的 DbParams 对象。 /// DbParams 对象用于设置执行 SQL 语句所需要的参数。 /// </summary> /// <param name="ParamNames">字符串类型的数组，表示多个参数名称，例如：new string[]{"@Param1", "@Param2",..."@ParamN"}</param> /// <param name="ParamTypes">DbType 类型的数组，指定对应前面的各个参数的类型。</param> /// <param name="ParamValues">object 类型的数组，指定对应前面的各个参数的值。</param> /// <returns>返回 一个包含 0 个或多个参数对象（IDbDataParameter）的 DbParams 对象。</returns> public static DbParams CreateDbParams(string[] ParamNames, System.Data.DbType[] ParamTypes, object[] ParamValues) /// <summary> /// 创建 DbParams 对象，根据传入的参数名称数组、参数类型数组、参数值数组、参数传递方向数组返回一个包含 0 个或多个参数对象（IDbDataParameter）的 DbParams 对象。 /// DbParams 对象用于设置执行 SQL 语句所需要的参数。 /// </summary> /// <param name="ParamNames">字符串类型的数组，表示多个参数名称，例如：new string[]{"@Param1", "@Param2",..."@ParamN"}</param> /// <param name="ParamTypes">DbType 类型的数组，指定对应前面的各个参数的类型。</param> /// <param name="ParamValues">object 类型的数组，指定对应前面的各个参数的值。</param> /// <param name="ParamDirections">ParameterDirection 类型的数组，指定对应前面各个参数的传递方向。</param> /// <returns>返回 一个包含 0 个或多个参数对象（IDbDataParameter）的 DbParams 对象。</returns> public static DbParams CreateDbParams( string[] ParamNames, DbType[] ParamTypes, object[] ParamValues, ParameterDirection[] ParamDirections ) /// <summary> /// 创建 DbParams 对象，根据传入的参数名称、参数类型返回一个包含 1 个参数对象（IDbDataParameter）的 DbParams 对象。 /// DbParams 对象用于设置执行 SQL 语句所需要的参数。 /// </summary> /// <param name="ParamName">参数名称。</param> /// <param name="ParamType">参数类型。</param> /// <returns>返回 一个包含 1 个参数对象（IDbDataParameter）的 DbParams 对象。</returns> public static DbParams CreateDbParams(string ParamName, DbType ParamType) /// <summary> /// 创建 DbParams 对象，根据传入的参数名称、参数类型返回一个包含 1 个参数对象（IDbDataParameter）的 DbParams 对象。 /// DbParams 对象用于设置执行 SQL 语句所需要的参数。 /// </summary> /// <param name="ParamName">参数名称。</param> /// <param name="ParamType">参数类型。</param> /// <param name="ParamValue">参数值。</param> /// <returns>返回 一个包含 1 个参数对象（IDbDataParameter）的 DbParams 对象。</returns> public static DbParams CreateDbParams(string ParamName, DbType ParamType, object ParamValue) /// <summary> /// 创建 DbParams 对象，根据传入的参数名称、参数类型返回一个包含 1 个参数对象（IDbDataParameter）的 DbParams 对象。 /// DbParams 对象用于设置执行 SQL 语句所需要的参数。 /// </summary> /// <param name="ParamName">参数名称。</param> /// <param name="ParamType">参数类型。</param> /// <param name="ParamValue">参数值。</param> /// <param name="ParamDirection">参数传递方向。</param> /// <returns>返回 一个包含 1 个参数对象（IDbDataParameter）的 DbParams 对象。</returns> public static DbParams CreateDbParams(string ParamName, DbType ParamType, object ParamValue, ParameterDirection ParamDirection) /// <summary> /// 执行 无返回结果的存储过程，或执行结果通过传出（Output、InputOutput）类型的参数获取。 /// </summary> /// <param name="ProcedureName">存储过程名称。</param> /// <param name="Params">存储过程参数对象：DbParams。</param> public static void ExecuteProcedure( string ProcedureName, DbParams Params ) /// <summary> /// 执行 返回包含查询结果的 IDataReaderWrapper 对象的存储过程。 /// </summary> /// <param name="ProcedureName">存储过程名称。</param> /// <param name="Params">存储过程参数对象：DbParams。</param> /// <returns>返回 包含查询结果的 IDataReaderWrapper 对象。</returns> public static IDataReaderWrapper ExecuteProcedureReader( string ProcedureName, DbParams Params ) /// <summary> /// 执行 返回包含查询结果的 DataSet 对象的存储过程。 /// </summary> /// <param name="ProcedureName">存储过程名称。</param> /// <param name="Params">存储过程参数对象：DbParams。</param> /// <returns>返回 包含查询结果的 DataSet 对象。</returns> public static DataSet ExecuteProcedureDataSet( string ProcedureName, DbParams Params ) /// <summary> /// 执行 返回包含查询结果的 DataTable 对象的存储过程。 /// </summary> /// <param name="ProcedureName">存储过程名称。</param> /// <param name="Params">存储过程参数对象：DbParams。</param> /// <returns>返回 包含查询结果的 DataTable 对象。</returns> public static DataTable ExecuteProcedureTable( string ProcedureName, DbParams Params ) /// <summary> /// 执行 返回仅包含传出（Output、InputOutput）类型的参数对象（DbParams）的存储过程。 /// </summary> /// <param name="ProcedureName">存储过程名称。</param> /// <param name="Params">存储过程参数对象：DbParams，需要指定传出的参数。</param> /// <returns>返回 仅包含传出（Output、InputOutput）类型的参数对象（DbParams）的存储过程。</returns> public static DbParams ExecuteProcedureResults( string ProcedureName, DbParams Params ) /// <summary> /// 执行 无参数和返回值的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> public static void ExecuteNone( string SqlString ) /// <summary> /// 执行 无参数的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> public static void ExecuteNone( string SqlString, DbParams Params ) /// <summary> /// 执行 返回 IDataReaderWrapper 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <returns>返回 IDataReaderWrapper 对象。</returns> public static IDataReaderWrapper ExecuteReader( string SqlString ) /// <summary> /// 执行 返回 IDataReaderWrapper 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <returns>返回 IDataReaderWrapper 对象。</returns> public static IDataReaderWrapper ExecuteReader( string SqlString, DbParams Params ) /// <summary> /// 执行 返回 DataSet 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <returns>返回 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString ) /// <summary> /// 执行 从指定的行号开始，返回包含指定记录行数的 DataSet 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <returns>从指定的行号开始，返回包含指定记录行数的 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString, int StartRowNo, int MaxRowCount ) /// <summary> /// 执行 返回 DataSet 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <returns>返回 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString, DbParams Params ) /// <summary> /// 执行 从指定的行号开始，返回包含指定记录行数的 DataSet 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <returns>从指定的行号开始，返回包含指定记录行数的 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString, DbParams Params, int StartRowNo, int MaxRowCount ) /// <summary> /// 执行 返回指定结果数据集表名称的 DataSet 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 指定结果数据集表名称的 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString, string TableName ) /// <summary> /// 执行 从指定的行号开始，返回包含指定记录行数的 DataSet 对象的 SQL 语句，并指定映射表名称。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 指定结果数据集表名称的 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString, int StartRowNo, int MaxRowCount, string TableName ) /// <summary> /// 执行 返回 DataSet 对象的 SQL 语句，并指定映射表名称。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 指定结果数据集表名称的 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString, DbParams Params, string TableName ) /// <summary> /// 执行 返回 DataSet 对象的 SQL 语句，并指定映射表名称。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 指定结果数据集表名称的 DataSet 对象。</returns> public static DataSet ExecuteDataSet( string SqlString, DbParams Params, int StartRowNo, int MaxRowCount, string TableName ) /// <summary> /// 执行 返回 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <returns>返回 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString ) /// <summary> /// 执行 从指定的行号开始，返回包含指定记录行数的 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <returns>从指定的行号开始，返回包含指定记录行数的 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString, int StartRowNo, int MaxRowCount ) /// <summary> /// 执行 返回 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <returns>返回 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString, DbParams Params ) /// <summary> /// 执行 从指定的行号开始，返回包含指定记录行数的 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <returns>从指定的行号开始，返回包含指定记录行数的 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString, DbParams Params, int StartRowNo, int MaxRowCount ) /// <summary> /// 执行 返回指定映射表名称 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString, string TableName ) /// <summary> /// 执行 从指定的行号开始，返回包含指定记录行数并指定映射表名称的 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 从指定的行号开始，包含指定记录行数并指定映射表名称的 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString, int StartRowNo, int MaxRowCount, string TableName ) /// <summary> /// 执行 返回指定映射表名称的 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 指定映射表名称的 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString, DbParams Params, string TableName ) /// <summary> /// 执行 从指定的行号开始，返回包含指定记录行数并指定映射表名称的 DataTable 对象的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <param name="StartRowNo">开始行号。</param> /// <param name="MaxRowCount">记录行数。</param> /// <param name="TableName">映射表名称。</param> /// <returns>返回 从指定的行号开始，包含指定记录行数并指定映射表名称的 DataTable 对象。</returns> public static DataTable ExecuteDataTable( string SqlString, DbParams Params, int StartRowNo, int MaxRowCount, string TableName ) /// <summary> /// 执行 返回单行单字段查询结果的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <returns>返回 单行单字段查询结果。</returns> public static object ExecuteScalar( string SqlString ) /// <summary> /// 执行 返回单行单字段查询结果的 SQL 语句。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <returns>返回 单行单字段查询结果。</returns> public static object ExecuteScalar( string SqlString, DbParams Params ) /// <summary> /// 更新 DataSet 对象中的数据。 /// </summary> /// <param name="ADataSet">包含更新数据的 DataSet 对象。</param> /// <param name="SqlString">对应要更新的表的查询语句。</param> /// <returns>返回成功更新的记录条数。</returns> public static int UpdateDataSet( DataSet ADataSet, string SqlString ) /// <summary> /// 更新 DataSet 对象中的数据。 /// </summary> /// <param name="ADataSet">包含更新数据的 DataSet 对象。</param> /// <param name="SqlString">对应要更新的表的查询语句。</param> /// <param name="ATableName">指定 DataSet 对象中要更新数据的表。</param> /// <returns>返回成功更新的记录条数。</returns> public static int UpdateDataSet( DataSet ADataSet, string SqlString, string ATableName ) /// <summary> /// 更新 DataTable 对象中的数据。 /// </summary> /// <param name="ADataTable">包含更新数据的 DataTable 对象。</param> /// <param name="SqlString">对应要更新的表的查询语句。</param> /// <returns>返回成功更新的记录条数。</returns> public static int UpdateDataTable( DataTable ADataTable, string SqlString ) /// <summary> /// 更新 DataRow 数组中的数据。 /// </summary> /// <param name="DataRows">包含更新数据的 DataRow 数组。</param> /// <param name="SqlString">对应要更新的表的查询语句。</param> /// <returns>返回成功更新的记录条数。</returns> public static int UpdateDataRows( DataRow[] DataRows, string SqlString ) /// <summary> /// 检查 SQL 语句是否有查询结果记录。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <returns>如果查询结果有记录，返回 true，否则返回 false。</returns> public static bool IsExists(string SqlString) /// <summary> /// 检查 SQL 语句是否有查询结果记录。 /// </summary> /// <param name="SqlString">SQL 语句。</param> /// <param name="Params">DbParams 参数对象。</param> /// <returns>如果查询结果有记录，返回 true，否则返回 false。</returns> public static bool IsExists(string SqlString, DbParams Params) |
| 查看该用户更多文章>> |