windows平台的分布式微服务解决方案(7)--IDataAccess工具介绍(数据访问)
在DeveloperSharp框架中，存在两个非常强大的工具接口，一个是IUtility工具接口（提供一系列有用的功能），一个是IDataAccess工具接口（提供数据访问功能）。
本文将具体介绍IDataAccess。
IDataAccess所在的命名空间是：DeveloperSharp.Framework.QueryEngine。
它主要提供了如下四大功能：
（1） 执行Sql语句
（2） 执行Sp存储过程
（3） 创建参数(输入/输出/返回)
（4） 事务
它初始化的代码如下：
using DeveloperSharp.Framework.QueryEngine; -------------------------- DatabaseInfo DIF; DIF.DatabaseType = DatabaseType.SQLServer; DIF.ConnectionString = "Server=localhost;Database=YZZ;Uid=sa;Pwd=123"; IDataAccess IDA = DataAccessFactory.Create(DIF);
下面给出一个结合“Sql语句+参数+事务”的使用示例，代码如下：
try { //开启事务 IDA.TransactionBegin(); //执行带参数的Sql语句 var newQuantity = IDA.CreateParameterInput("newQuantity", DbType.Int32, 506); var newName = IDA.CreateParameterInput("newName", DbType.String, 50, "帽子"); IDA.SqlExecuteNonQuery("update t_Order set Quantity=@newQuantity where Id=1", newQuantity); IDA.SqlExecuteNonQuery("update t_Order set Quantity=@newQuantity,Name=@newName where Id=3", newQuantity, newName); //完成事务 IDA.TransactionCommit(); } catch { //回滚事务 IDA.TransactionRollBack(); }
IDataAccess内拥有的详细功能方法说明如下：
DatabaseType 声明：DatabaseType DatabaseType{get;} 用途：获取数据库类型 返回：DatabaseType -- 数据库类型枚举 ConnectionString 声明：string ConnectionString{get;} 用途：获取数据库链接字符串 返回：string -- 数据库链接字符串 CreateParameterInput 声明：IDataParameter CreateParameterInput(string name, DbType type, int size, object val) 用途：创建输入参数 参数：（1）string name -- 参数名 （2）DbType type -- 参数类型 （3）int size -- 参数大小 （4）object val --参数值 返回：IDataParameter -- 输入参数 CreateParameterInput 声明：IDataParameter CreateParameterInput(string name, DbType type, object val) 用途：创建输入参数 参数：（1）string name -- 参数名 （2）DbType type -- 参数类型 （3）object val --参数值 返回：IDataParameter -- 输入参数 CreateParameterOutput 声明：IDataParameter CreateParameterOutput(string name, DbType type, int size) 用途：创建输出参数 参数：（1）string name --参数名 （2）DbType type --参数类型 （3）int size --参数大小 返回：IDataParameter -- 输出参数 CreateParameterOutput 声明：IDataParameter CreateParameterOutput(string name, DbType type) 用途：创建输出参数 参数：（1）string name --参数名 （2）DbType type --参数类型 返回：IDataParameter -- 输出参数 CreateParameterReturn() 声明：IDataParameter CreateParameterReturn() 用途：创建返回参数 参数：（无） 返回：IDataParameter -- 返回参数 TransactionBegin 声明：void TransactionBegin() 用途：开启事务 参数：（无） 返回：（无） TransactionCommit 声明：void TransactionCommit() 用途：完成事务 参数：（无） 返回：（无） TransactionRollBack 声明：void TransactionRollBack 用途：回滚事务 参数：（无） 返回：（无） SqlExecuteNonQuery 声明：int SqlExecuteNonQuery(string cmdText) 用途：执行Sql命令文本，返回受影响的行数 参数：（1）string cmdText -- Sql命令文本 返回：int --受影响的行数 SqlExecuteNonQuery 声明：int SqlExecuteNonQuery(string cmdText , params IDataParameter[] cmdParameters) 用途：执行Sql命令文本，返回受影响的行数 参数：（1）string cmdText -- Sql命令文本 （2）params IDataParameter[] cmdParameters --命令参数数组 返回：int --受影响的行数 SpExecuteNonQuery 声明：int SpExecuteNonQuery(string cmdText) 用途：执行Store Procedure命令文本，返回受影响的行数 参数：（1）string cmdText --Store Procedure命令文本 返回：int --受影响的行数 SpExecuteNonQuery 声明：int SpExecuteNonQuery(string cmdText, params IDataParameter[] cmdParameters) 用途：执行Store Procedure命令文本，返回受影响的行数 参数：（1）string cmdText -- Store Procedure命令文本 （2）params IDataParameter[] cmdParameters --命令参数数组 返回：int --受影响的行数 SqlExecuteReader 声明：IDataReader SqlExecuteReader(string cmdText) 用途：执行Sql命令文本，返回DataReader对象 参数：（1）string cmdText -- Sql命令文本 返回：IDataReader -- DataReader对象 SqlExecuteReader 声明：IDataReader SqlExecuteReader (string cmdText, params IDataParameter[] cmdParameters) 用途：执行Sql命令文本，返回DataReader对象 参数：（1）string cmdText -- Sql命令文本 （2）params IDataParameter[] cmdParameters --命令参数数组 返回：IDataReader -- DataReader对象 SpExecuteReader 声明：IDataReader SpExecuteReader(string cmdText) 用途：执行Store Procedure命令文本，返回DataReader对象 参数：（1）string cmdText -- Store Procedure命令文本 返回：IDataReader -- DataReader对象 SpExecuteReader 声明：IDataReader SpExecuteReader(string cmdText, params IDataParameter[] cmdParameters) 用途：执行Store Procedure命令文本，返回DataReader对象 参数：（1）string cmdText -- Store Procedure命令文本 （2）params IDataParameter[] cmdParameters --命令参数数组 返回：IDataReader -- DataReader对象 SqlExecuteScalar 声明：object SqlExecuteScalar(string cmdText) 用途：执行Sql命令文本，返回sum、avg、max等聚合函数计算出的值 参数：（1）string cmdText -- Sql命令文本 返回：object --聚合函数计算出的值 SqlExecuteScalar 声明：object SqlExecuteScalar(string cmdText, params IDataParameter[] cmdParameters) 用途：执行Sql命令文本，返回sum、avg、max等聚合函数计算出的值 参数：（1）string cmdText -- Sql命令文本 （2）params IDataParameter[] cmdParameters --命令参数数组 返回：object --聚合函数计算出的值 SpExecuteScalar 声明：object SpExecuteScalar(string cmdText) 用途：执行Store Procedure命令文本，返回sum、avg、max等聚合函数计算出的值 参数：（1）string cmdText -- Store Procedure命令文本 返回：object --聚合函数计算出的值 SpExecuteScalar 声明：object SpExecuteScalar(string cmdText, params IDataParameter[] cmdParameters) 用途：执行Store Procedure命令文本，返回sum、avg、max等聚合函数计算出的值 参数：（1）string cmdText -- Store Procedure命令文本 （2）params IDataParameter[] cmdParameters --命令参数数组 返回：object --聚合函数计算出的值 SqlExecuteDataset 声明：void SqlExecuteDataset(string cmdText, DataSet ds) 用途：执行Sql命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Sql命令文本 （2）DataSet ds --数据集对象 返回：（无） SqlExecuteDataset 声明：void SqlExecuteDataset(string cmdText, DataSet ds, string tableName) 用途：执行Sql命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Sql命令文本 （2）DataSet ds --数据集对象 （3）string tableName --数据集中的数据表名 返回：（无） SqlExecuteDataset 声明：void SqlExecuteDataset(string cmdText, DataSet ds, params IDataParameter[] cmdParameters) 用途：执行Sql命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Sql命令文本 （2）DataSet ds --数据集对象 （3）params IDataParameter[] cmdParameters --命令参数数组 返回：（无） SqlExecuteDataset 声明：void SqlExecuteDataset(string cmdText, DataSet ds, string tableName, params IDataParameter[] cmdParameters) 用途：执行Sql命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Sql命令文本 （2）DataSet ds --数据集对象 （3）string tableName --数据集中的数据表名 （4）params IDataParameter[] cmdParameters --命令参数数组 返回：（无） SpExecuteDataset 声明：void SpExecuteDataset(string cmdText, DataSet ds) 用途：执行Store Procedure命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Store Procedure命令文本 （2）DataSet ds --数据集对象 返回：（无） SpExecuteDataset 声明：void SpExecuteDataset(string cmdText, DataSet ds, string tableName) 用途：执行Store Procedure命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Store Procedure命令文本 （2）DataSet ds --数据集对象 （3）string tableName --数据集中的数据表名 返回：（无） SpExecuteDataset 声明：void SpExecuteDataset(string cmdText, DataSet ds, params IDataParameter[] cmdParameters) 用途：执行Store Procedure命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Store Procedure命令文本 （2）DataSet ds --数据集对象 （3）params IDataParameter[] cmdParameters --命令参数数组 返回：（无） SpExecuteDataset 声明：void SpExecuteDataset(string cmdText, DataSet ds, string tableName, params IDataParameter[] cmdParameters) 用途：执行Store Procedure命令文本，获取相应的DataSet数据集 参数：（1）string cmdText -- Store Procedure命令文本 （2）DataSet ds --数据集对象 （3）string tableName --数据集中的数据表名 （4）params IDataParameter[] cmdParameters --命令参数数组 返回：（无）
【本文采用.NET/C#语言撰写，如需其它语言版本，请联系作者索取。】
相关下载：
文章来源：https://www.cnblogs.com/DeveloperSharp/p/15722744.html
版权声明：本文为YES开发框架网发布内容,转载请附上原文出处连接
CSharp 管理员
