[C#]JCoder.Db4Net.SqlServer ，轻量的SqlServer数据处理类库，MIT协议

置顶 JackieLaw1990

已于 2022-09-16 16:31:51 修改

阅读量248

点赞数 1

分类专栏： .Net SqlServer C# 文章标签： c# sqlserver 数据库

于 2022-08-18 15:53:57 首次发布

本文链接：https://blog.csdn.net/Jack_Law/article/details/126407599

版权

C# 同时被 3 个专栏收录

26 篇文章 0 订阅

订阅专栏

.Net

20 篇文章 1 订阅

订阅专栏

SqlServer

1 篇文章 0 订阅

订阅专栏

文章目录

@[toc]
架构说明
引用类库
相关类库

获取方式
使用说明
主要类与接口
创建实例
MsSqlFactoryOperator
MsSqler

MsSqler使用
CanConnect（是否能够连接数据库）
CreateParameter（创建相应的参数）
Execute（执行SQL）
Execute（执行多条SQL）
ExecuteTransaction（使用事务执行指定的SQL）
ExecuteTransaction（使用指定的事务执行指定的SQL）
RollbackTransaction（回滚指定的事务）
QueryTable（查询数据，并返回DataTable）
QueryTables（查询数据，并返回DataSet）
QueryReader（查询数据，并返回DbDataReader）
QueryDictionary (将查询结果的首两列数据转换为Dictionary)
QueryValues (将查询结果的首列数据转换为List)
QueryValue (将查询值转换为long)
IsExistData (查询是否存在数据)

IDbSqlTexter使用
生成实例
生成数据库相关的SQL语句
生成数据表(Table)相关的SQL语句
生成视图(View)相关的SQL语句
生成函数(Function)相关的SQL语句
生成存储过程(Procedure)相关的SQL语句

实例使用

架构说明

JCoder.Db4Net.SqlServer
语言	C#
协议	MIT
.Net框架	.Net Standard2.1; .Net Framework 4.7.2; .Net 5; .Net 6;
简述	Database类库，一个基于JCoder.Db4Net且支持Sql Server的库。

引用类库

引用类库	版本
JCoder.Db4Net	>=2.18.1
System.Data.SqlClient	>=4.8.2

相关类库	说明
JCoder.Db4Net	一款为方便使用数据库的操作类库，JCore.Db4Net的新版本。
JCoder.Db4Net.ORM	一个基于JCoder.Db4Net的ORM库，JCore.Db4Net.ORM的新版本。
JCoder.Db4Net.Sqlite	一个基于JCoder.Db4Net且支持Sqlite的库，JCore.Db4Net.Sqlite的新版本。
JCoder.Db4Net.MySql	一个基于JCoder.Db4Net且支持Mysql的库，JCore.Db4Net.MySql的新版本。
JCoder.Db4Net.SqlServer	一个基于JCoder.Db4Net且支持SqlServer的库，JCore.Db4Net.SqlServer的新版本。
JCoder.Mock4Net	一款简易版的用于模拟数据的功能库。

获取方式

版本要求：>=2.18.1
以版本2.18.1为例

获取方式	描述
Package Manager	`Install-Package JCoder.Db4Net.SqlServer -Version 2.18.1`
.Net CLI	`dotnet add package JCoder.Db4Net.SqlServer --version 2.18.1`
PackageReference	`<PackageReference Include="JCoder.Db4Net.SqlServer" Version="2.18.1" />`
Paket CLI	`paket add JCoder.Db4Net.SqlServer --version 2.18.1`
Script&Interactive	`#r "nuget: JCoder.Db4Net.SqlServer, 2.18.1"`
Cake	// Install as a Cake Addin #addin nuget:?package=JCoder.Db4Net.SqlServer&version=2.18.1 // Install as a Cake Tool #tool nuget:?package=JCoder.Db4Net.SqlServer&version=2.18.1

使用说明

主要类与接口

名称	类型	描述
MsSqlTexter	类	主要用于SqlServer的SQL语句的生成。
MsSqlBuilder	类	主要用于SqlServer数据库结构的处理。
MsSqler	类	主要用于SqlServer的SQL的执行与处理。
DbMsSql	类	工具类，主要用于SqlServer数据库通用的处理。

创建实例

MsSqlFactoryOperator

需要先在项目里引用或加载Sql Server官方库System.Data.SqlClient.dll。

   IDbOperator _operator = new MsSqlFactoryOperator()
   {
       ConnectionString = "Server=127.0.0.1;Database=test;Uid = user; Pwd=testpassword;"
   };

MsSqler

IDbOperator _operator = new MsSqler()
{
       ConnectionString = "Server=127.0.0.1;Database=test;Uid = user; Pwd=testpassword;"
};

MsSqler使用

CanConnect（是否能够连接数据库）

// CanConnect（是否能够连接数据库）
if (_dber.CanConnect()) { return; }

CreateParameter（创建相应的参数）

// CreateParameter（创建相应的参数）
return _dber.CreateParameter( "ID", 123);

Execute（执行SQL）

// Execute（执行SQL）
var _parameters = new List<DbParameter>()
{
    _dber.CreateParameter("ID","ID123"),
    _dber.CreateParameter("Name","Name123"),
    _dber.CreateParameter("CreateTime",DateTime.Now),
};
var _sql = @"insert table1 (ID,Name,CreateTime) values (@ID,@Name,@CreateTime);";
var _count = _dber.Execute(_sql, _parameters);//直接执行SQL
//var _count = _dber.Execute(true,_sql, _parameters);// 使用事务执行SQL
return _count >= 1;

Execute（执行多条SQL）

// Execute（执行多条SQL）
var _parameters = new List<DbParameter>()
{
    _dber.CreateParameter("Value1","ID123"),
    _dber.CreateParameter("Value2","Name123"),
    _dber.CreateParameter("Value3","Name1456"),
};
var _sqls = new string[]
{
    @"insert table3 (Values) values (@Value1);",
    @"insert table3 (Values) values (@Value2);",
    @"insert table3 (Values) values (@Value3);",
} ;
var _count = _dber.Execute(_sqls, _parameters);//直接执行SQL
//var _count = _dber.Execute(true, _sqls, _parameters);// 使用事务执行SQL
return _count >= 1;

ExecuteTransaction（使用事务执行指定的SQL）

// ExecuteTransaction（使用事务执行指定的SQL）
public void ExecuteTransaction()
{
    _dber.StartTransaction();

     try
     {
        for (int i = 0; i < 3; i++)
        {
             var _parameters = new List<DbParameter>()
             {
                 _dber.CreateParameter("ID",i.ToString()),
                 _dber.CreateParameter("Name","Name123"),
                 _dber.CreateParameter("CreateTime",DateTime.Now),
             };
             var _sql = @"insert table1 (ID,Name,CreateTime) values (@ID,@Name,@CreateTime);";
             var _isSucceed = _dber.ExecuteTransaction(_sql, _parameters);
        }
     }
     catch (Exception ex)
     {
         _dber.RollbackTransaction();
         return;
     }
        
     _dber.FinishTransaction();
}

ExecuteTransaction（使用指定的事务执行指定的SQL）

// ExecuteTransaction（使用指定的事务执行指定的SQL）
public void ExecuteTransaction()
{
    for (int i = 0; i < 3; i++)
    {
        var _key = "Transaction" + i.ToString();
        _dber.StartTransaction(_key);

        var _id = i.ToString() + DateTime.Now.ToLongTimeString();
        try
        {
            var _parameters = new List<DbParameter>()
            {
                _dber.CreateParameter("ID",_id),
                _dber.CreateParameter("Name","Name123"),
                _dber.CreateParameter("CreateTime",DateTime.Now),
            };
            var _sql = @"insert table1 (ID,Name,CreateTime) values (@ID,@Name,@CreateTime);";
            var _isSucceed = _dber.ExecuteTransaction(_key, _sql, _parameters);
        }
        catch (Exception ex)
        {
            _dber.RollbackTransaction(_key);
            return;
        }
        
        if (!_dber.FinishTransaction(_key))
        {
            return;
        }
    }
}

RollbackTransaction（回滚指定的事务）

// RollbackTransaction（回滚指定的事务）
public void RollbackTransaction()
{
    var _key = "Transaction";
    _dber.StartTransaction(_key);

    var _id = nameof(RollbackTransaction);
    
    try
    {
        var _parameters = new List<DbParameter>()
        {
            _dber.CreateParameter("ID",_id),
            _dber.CreateParameter("Name","Name123"),
            _dber.CreateParameter("CreateTime",DateTime.Now),
        };
        var _sql = @"insert table1 (ID,Name,CreateTime) values (@ID,@Name,@CreateTime);";
        var _isSucceed = _dber.ExecuteTransaction(_key, _sql, _parameters);
    }
    catch (Exception ex)
    {
        _dber.RollbackTransaction(_key);
        return;
    }
    
    _dber.RollbackTransaction(_key);
}

QueryTable（查询数据，并返回DataTable）

public DataTable QueryTable()
{
    var _parameters = new List<DbParameter>()
    {
        _dber.CreateParameter("ID",123),
    };
    var _sql = "select * from table1 where ID=@ID;";
    return _dber.QueryTable(_sql, _parameters);
}

QueryTables（查询数据，并返回DataSet）

public DataSet QueryTables()
{
    var _parameters = new List<DbParameter>()
    {
        _dber.CreateParameter("ID",123),
    };
    var _sql = "select * from table1 where ID=@ID;";
    _sql += "select * from table2 where ID=@ID;";
    return _dber.QueryTables(_sql, _parameters);
}

QueryReader（查询数据，并返回DbDataReader）

public QueryReader QueryReader()
{
    var _parameters = new List<DbParameter>()
    {
        _dber.CreateParameter("ID",123),
    };
    var _sql = "select * from table1 where ID=@ID;";
    return _dber.QueryReader(_sql, _parameters);
}

QueryDictionary (将查询结果的首两列数据转换为Dictionary)

public Dictionary<string, string> QueryDictionary()
{
    var _sql = "select Key,Value from table1 ;";
    return _dber.QueryDictionary<string, string>(_sql);
}

QueryValues (将查询结果的首列数据转换为List)

public List<string> QueryNames()
{
    var _sql = "select Names from table1 ;";
    return _dber.QueryValues<string>(_sql);
}

QueryValue (将查询值转换为long)

public List<long> QueryValue()
{
    var _sql = "select count(1) from table1 ;";
    return _dber.QueryScalar<long>(_sql);
}

IsExistData (查询是否存在数据)

public bool IsExistData()
{
    var _sql = "select 1 from table1 where id=1;";
    return _dber.IsExistData(_sql);
}

IDbSqlTexter使用

生成实例


// 用于生成SqlServer语句
IDbSqlTexter _sqltexter = new MsSqlTexter();

生成数据库相关的SQL语句


// 生成获取当前数据库信息的SQL语句
_sqltexter.GetDatabase();

 // 生成获取指定数据库信息的SQL语句
_sqltexter.GetDatabase("database");

 // 生成获取数据库信息列表的SQL语句
_sqltexter.GetDatabaseList();

 // 生成创建数据库的SQL语句
_sqltexter.CreateDatabase("database");

 // 生成删除数据库的SQL语句
_sqltexter.DeleteDatabase("database");

生成数据表(Table)相关的SQL语句


// 生成获取当前数据库的指定数据表的数据列信息的SQL语句
_sqltexter.GetTableColumns("table01");
// 生成获取指定数据库的指定数据表的数据列信息的SQL语句
_sqltexter.GetTableColumns("database","table01");

 // 生成获取当前数据库的指定数据表信息的SQL语句SQL语句
_sqltexter.GetTable("table01");
 // 生成获取当前数据库的指定数据表信息的SQL语句SQL语句
_sqltexter.GetTable("database","table01");

 // 生成获取当前数据库的数据表列表的SQL语句
_sqltexter.GetTableList();
 // 生成获取指定数据库的数据表列表的SQL语句
_sqltexter.GetTableList("database");

 // 生成删除当前数据库的数据表的SQL语句
_sqltexter.DeleteTable("table01");
 // 生成删除指定数据库的数据表的SQL语句
_sqltexter.DeleteTable("database","table01");

 // 生成创建数据表的SQL语句
_sqltexter.CreateTable("table01", new List<DbColumn>());
 // 生成创建数据表的SQL语句
_sqltexter.CreateTable("database", "table01", new List<DbColumn>());

生成视图(View)相关的SQL语句


// 生成获取当前数据库的指定View的数据列信息的SQL语句
_sqltexter.GetViewColumns("view01");
// 生成获取指定数据库的指定View的数据列信息的SQL语句
_sqltexter.GetViewColumns("database","view01");

 // 生成获取当前数据库的指定View信息的SQL语句SQL语句
_sqltexter.GetView("view01");
 // 生成获取当前数据库的指定View信息的SQL语句SQL语句
_sqltexter.GetView("database","view01");

 // 生成获取当前数据库的View列表的SQL语句
_sqltexter.GetViewList();
 // 生成获取指定数据库的View列表的SQL语句
_sqltexter.GetViewList("database");

 // 生成删除当前数据库的View的SQL语句
_sqltexter.DeleteView("view01");
 // 生成删除指定数据库的View的SQL语句
_sqltexter.DeleteView("database","view01");

生成函数(Function)相关的SQL语句


// 生成获取当前数据库的指定函数信息的SQL语句
_sqltexter.GetFunction("func01");
// 生成获取指定数据库的指定函数信息的SQL语句
_sqltexter.GetFunction("database","func01");

 // 生成获取当前数据库的函数列表的SQL语句
_sqltexter.GetFunctionList();
 // 生成获取指定数据库的函数列表的SQL语句
_sqltexter.GetFunctionList("database");

 // 生成删除当前数据库的Function的SQL语句
_sqltexter.DeleteFunction("func01");
 // 生成删除指定数据库指定函数的SQL语句
_sqltexter.DeleteFunction("database","func01");

生成存储过程(Procedure)相关的SQL语句


// 生成获取当前数据库的指定存储过程信息的SQL语句
_sqltexter.GetProcedure("proc01");
// 生成获取指定数据库的指定存储过程信息的SQL语句
_sqltexter.GetProcedure("database","proc01");

 // 生成获取当前数据库的存储过程列表的SQL语句
_sqltexter.GetProcedureList();
 // 生成获取指定数据库的存储过程列表的SQL语句
_sqltexter.GetProcedureList("database");

 // 生成删除当前数据库的Procedure的SQL语句
_sqltexter.DeleteProcedure("proc01");
 // 生成删除指定数据库指定存储过程的SQL语句
_sqltexter.DeleteProcedure("database","proc01");