SqlSugar有实体CURD应用-C#

本文所述开发环境：.C#、NET8、Visual Studio2022

SqlSugar有实体查询数据表

首先根据《SqlSugar使用DbFirst对象根据数据库表结构创建实体类-C#》中的描述的表结构创建所有表的实体类如下：

表名	创建的实体类名
tb_student	Student
tb_teacher	Teacher
tb_class	CClass
tb_status	Status
tb_subject_selection	SubjectSelection

以下通过将对应的 sql 语句转换为 SqlSugar 的语法方式经行讲解。了解更多可以查看SqlSugar官网

为了可以直观的看到SqlSugar语法最终执行的sql语句，可以使用如下代码，将Sql语句输出到控制台，调试的时候用的较多。

using (SqlSugarClient sugarClient = new(connectionConfig))
{
	sugarClient.Aop.OnLogExecuting = (s, p) =>
	{
	    Console.WriteLine("===================================");
	    Console.WriteLine($"Sql语句：{ s }");
	};
	// 接下来编辑执行的SqlSugar代码
}

1. 单表查询

查询 tb_student表中的数据

Sql语句：select * from tb_student

代码如下：

List<Student> students = sugarClient.Queryable<Student>().ToList(); // list类型接收
// 或者
DataTable studentDT = sugarClient.Queryable<Student>().ToDataTable(); // DataTable类型接收

执行后控制台会输出对应的Sql语句，如下：

后面对于输出的语句不做再多的说明。

继续

Sql语句：select count(*) from tb_student

代码如下：
int nCount = sugarClient.Queryable<Student>().Count();

Sql语句：select top 1 * from tb_student

代码如下：

Student student = sugarClient.Queryable<Student>().First();
//或者
List<Student> student = sugarClient.Queryable<Student>().Take(1).ToList();

Sql语句：select top 10 * from tb_student

代码如下：
List<Student> student = sugarClient.Queryable<Student>().Take(10).ToList(); //和其它方法连用时， Task() 方法放在最后

Sql语句：select * from tb_student order by [身高]

代码如下：

List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy("[身高]").ToList();
// 或者
List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy(it=>it.身高).ToList();

Sql语句：select * from tb_student order by [身高] desc

代码如下：

List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy("[身高] DESC").ToList();
// 或者
List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy(it=>it.身高, OrderByType.Desc)
	.ToList();

Sql语句：select * from tb_student order by [年龄],[身高]

代码如下：

List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy("[年龄]")
	.OrderBy("[身高]")
	.ToList();
//或者
List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy("[年龄],[身高]").ToList();
//或者
List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy(it=>new { it.年龄, it.身高})
	.ToList();

Sql语句：select * from tb_student order by [年龄] asc ,[身高] desc

代码如下：

List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy(it=>new { it.年龄, 身高=SqlFunc.Desc(it.身高)})
	.ToList();
//或者
List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy(it=>it.年龄)
	.OrderBy(it=>it.身高, OrderByType.Desc)
	.ToList();
// 或者
List<Student> students = sugarClient.Queryable<Student>()
	.OrderBy("[年龄], [身高] DESC")
	.ToList();

Sql语句：select 姓名,性别 from tb_student

代码如下：

List<Student> students = sugarClient.Queryable<Student>()
.Select("姓名,性别").ToList();
//或者
List<Student> students = sugarClient.Queryable<Student>()
.Select(it=>new { it.姓名, it.性别}).ToList();

Sql语句：select * from tb_student where 班级ID=1003

代码如下：

List<Student> students = sugarClient.Queryable<Student>()
	.Where(it=>it.班级ID==1003).ToList();
//或者
List<Student> students = sugarClient.Queryable<Student>()
	.Where("班级ID=1003").ToList();

Sql语句：select 姓名,性别 from tb_student where 班级ID=1003 and 身高>165

代码如下：

var students = sugarClient.Queryable<Student>()
	.Where(it=>it.班级ID == 1003)
	.Where(it=>it.身高 > 165)
	.Select(it=>new { it.姓名, it.性别}).ToList();
//或者
var students = sugarClient.Queryable<Student>()
	.Where("班级ID = @classid and 身高 > @high", new { classid = 1003, high = 165 })
	.Select("姓名, 性别").ToList();

Sql语句：select * from tb_subject_selection where 课程 like '%化学%'

代码如下：

List<SubjectSelection> subjectsels = sugarClient.Queryable<SubjectSelection>()
   .Where("课程 like '%化学%'")
   .ToList();
//或者
List<SubjectSelection> subjectsels = sugarClient.Queryable<SubjectSelection>()
   .Where(it=>it.课程.Contains("化学"))
   .ToList();

Sql语句：select * from tb_student where 状态ID in (2, 3)

代码如下：

List<Student> students = sugarClient.Queryable<Student>()
   .Where("状态ID in (2, 3)")
   .ToList();
//或者
List<Student> students = sugarClient.Queryable<Student>()
   .Where("状态ID in (@statuslist)", new { statuslist = new[] { 2, 3 } })
   .ToList();
//或者
var statuslist = new[] { 2, 3 };
List<Student> students = sugarClient.Queryable<Student>()
	.Where(it=> statuslist.Contains(it.状态ID))
	.ToList();

在实际的项目中存在这样一种情况：有一个工具类，类中的字段只有对应表中的几个字段，如果直接用表实体类查询的话，会获取到全部的字段，那么如何将实体类中的对应几个字段赋值给工具类呢。

比如，以下是一个学生的工具类：MiniStudent，在整个项目就只用到了：学生ID、姓名、班级ID三个字段。

public class MiniStudent
{
    public int Id { get; set; }
    public string Name { get; set; }
    public int Class { get; set; }
}

使用SqlSugar将查询结果的相关字段赋值给工具类，代码如下：

方法一

List<MiniStudent> students = sugarClient.Queryable<Student>()
	.Select(it => new MiniStudent
	{
	     Id = it.学生ID,
	     Name = it.姓名,
	     Class = it.班级ID
	 }).ToList();

这种方式显然不是很好，为了得到MiniStudent ，需要有一个实体类Student，感觉多此一举。

方法二

直接将工具类MiniStudent 绑定到tb_student 表结构岂不是美哉。这种需要在MiniStudent 类的上面添加SugarTable 属性，并且类中的属性名都要是表中有的字段名 。

代码如下：

[SugarTable("tb_student")]
public class MiniStudent
{
    public int 学生ID { get; set; }
    public string 姓名 { get; set; }
    public int 班级ID { get; set; }
}

List<MiniStudent> miniStudents = sugarClient.Queryable<MiniStudent>().ToList();

这种相对好一点，但是有一个问题，假如类的属性名就是想用英文的怎么办，能否实现sql语句中的 AS 语法的功能呢。例如：

select 学生ID as Id, 姓名 as Name, 班级ID as Class from tb_student

方法三

在实体类中使用字段属性 [SugarColumn(ColumnName = "xxxx")]，这个意思就是告诉SqlSugar，要将表中的哪个字段赋值给实体类中的修饰属性字段。代码如下：

[SugarTable("tb_student")]
public class MiniStudent
{
    [SugarColumn(ColumnName = "学生ID")]
    public int Id { get; set; }

    [SugarColumn(ColumnName = "姓名")]
    public string Name { get; set; }

    [SugarColumn(ColumnName = "班级ID")]
    public int Class { get; set; }
}

List<MiniStudent> miniStudents = sugarClient.Queryable<MiniStudent>().ToList();

上面这样就可以了，属性SugarColumn告诉SqlSugar:

将表字段 学生ID 的内容赋值给 Id 类字段
将表字段姓名的内容赋值给 Name 类字段
将表字段 班级ID 的内容赋值给 Class 类字段

另一种情况：实体类中除了表字段对应的属性字段，还有一些不是表字段中对应的属性，而这些属性又是要用到的，如果还是像上面一样查询就是异常。

例如:还是工具类MiniStudent，但是定义如下：

[SugarTable("tb_student")]
public class MiniStudent
{
    [SugarColumn(ColumnName = "学生ID")]
    public int Id { get; set; }

    [SugarColumn(ColumnName = "姓名")]
    public string Name { get; set; }

    [SugarColumn(ColumnName = "班级ID")]
    public int Class { get; set; }

    public string strKey { get; set; }
}

类中多了一个 strKey 的属性字段，这个属性并不是从表中查询获取，但后续代码又会用到，那能不能忽略这个属性字段进行查询呢？答案是肯定的，只需要将要忽略查询的字段加上属性 [SugarColumn(IsIgnore = true)] 即可，代码如下：

[SugarTable("tb_student")]
public class MiniStudent
{
    [SugarColumn(ColumnName = "学生ID")]
    public int Id { get; set; }

    [SugarColumn(ColumnName = "姓名")]
    public string Name { get; set; }

    [SugarColumn(ColumnName = "班级ID")]
    public int Class { get; set; }

    [SugarColumn(IsIgnore = true)]
    public string strKey { get; set; }
}

List<MiniStudent> miniStudents = sugarClient.Queryable<MiniStudent>().ToList();

再谈一种情况：给实体类和类中每个属性字段都加上SqlSugar的字段属性标签太麻烦了，不想这样，能不能直接用SqlSugar的方法实现？答案也是肯定的。

例如：MiniStudent 类定义如下：

public class MiniStudent
{
    public int Id { get; set; }

    public string Name { get; set; }

    public int Class { get; set; }

    public string strKey { get; set; }
}
// 可以用以下方法实现
List<MiniStudent> students = sugarClient.Queryable<MiniStudent>()
    .AS("tb_student") // 指定要查的表名
    .IgnoreColumns(it=>it.strKey)  // 指定实体类中要忽略的属性字段
    .Select("学生ID as Id, 姓名 as Name, 班级ID as Class") // 指定表字段别名
    .ToList();

2. 多表查询

Sql语句：select 班级名称, 姓名 as 班主任 from tb_class a left join tb_teacher b on a.班主任 = b.教师ID

代码如下：
var result = sugarClient.Queryable<CClass>()
	.LeftJoin<Teacher>((a, b) => a.班主任 == b.教师ID)
	.Select((a, b) => new { a.班级名称, 班主任 = b.姓名 })
	.ToList();
// 或者
var queryable = sugarClient.Queryable<CClass>();
var result = sugarClient.Queryable(queryable)
	.LeftJoin<Teacher>((a, b) => a.班主任 == b.教师ID)
	.Select((a, b) => new { a.班级名称, 班主任 = b.姓名 })
	.ToDataTable();
RightJoin与LeftJoin一样，两个表以上的联合查询也类似，不断的连接起来就可以了。

SqlSugar有实体增加表中数据

向表tb_student中插入一行新的记录

代码如下

Student newstudent = new Student()
{
    学生ID = 110,
    姓名 = "黄同学",
    班级ID = 1002,
    状态ID = 1,
    性别 = "男",
    年龄 = 30,
    身高 = 175,
    体重 = 69
};

int insertnum = sugarClient.Insertable(newstudent).ExecuteCommand(); // 返回插入的行数

批量插入多条数据

List<Student> newStudents = [];

for (int i = 0; i < 10; i++)
{
Student newstudent = new Student()
{
学生ID = 111 + i,
姓名 = $"黄同学{i}",
班级ID = 1002,
状态ID = 1,
性别 = i>5?"男":"女",
年龄 = 30 + i,
身高 = 175 + i / 10.0,
体重 = 69 + i / 10.0
};
```
  newStudents.Add(newstudent);
```
}

int insertnum = sugarClient.Insertable(newStudents).ExecuteCommand(); // 返回插入的行数

SqlSugar有实体更新表中数据

更新表中单个字段

Sql语句：update tb_student set 班级ID=1001 where 学生ID=109

代码如下：
sugarClient.Updateable<Student>()
	.SetColumns(it=>it.班级ID == 1001) // 注意：这里也是两个等号
	.Where(it=>it.学生ID == 109)
	.ExecuteCommand();

跟新表中多个字段

Sql语句：update tb_student set 班级ID=1001, 状态ID=3 where 学生ID=109

sugarClient.Updateable<Student>()
	.SetColumns(it=>it.班级ID == 1001) // 注意：这里也是两个等号
	.SetColumns(it=>it.状态ID == 3)
	.Where(it=>it.学生ID == 109)
	.ExecuteCommand();
// 或者
sugarClient.Updateable<Student>()
	.SetColumns(it=> new Student() { 班级ID = 1002, 状态ID = 2 }) // 注意：这里是一个等号
	.Where(it=>it.学生ID == 109)
	.ExecuteCommand();

SqlSugar有实体删除表中数据

删除符合条件的记录

Sql语句：delete from tb_student where 学生ID=120

代码如下：

sugarClient.Deleteable<Student>(it=>it.学生ID == 120).ExecuteCommand();
// 或者
sugarClient.Deleteable<Student>(new Student() { 学生ID=120}).ExecuteCommand();

清空表记录

Sql语句：truncate table tb_student

代码如下：
sugarClient.DbMaintenance.TruncateTable<Student>();

SqlSugar有实体CURD应用-C#

SqlSugar有实体查询数据表

以下通过将对应的 sql 语句转换为 SqlSugar 的语法方式经行讲解。了解更多可以查看SqlSugar官网

1. 单表查询

在实际的项目中存在这样一种情况：有一个工具类，类中的字段只有对应表中的几个字段，如果直接用表实体类查询的话，会获取到全部的字段，那么如何将实体类中的对应几个字段赋值给工具类呢。

方法一

方法二

方法三

另一种情况：实体类中除了表字段对应的属性字段，还有一些不是表字段中对应的属性，而这些属性又是要用到的，如果还是像上面一样查询就是异常。

再谈一种情况：给实体类和类中每个属性字段都加上SqlSugar的字段属性标签太麻烦了，不想这样，能不能直接用SqlSugar的方法实现？答案也是肯定的。

2. 多表查询

SqlSugar有实体增加表中数据

SqlSugar有实体更新表中数据

SqlSugar有实体删除表中数据

好了，分享到这里，感谢翻阅，希望帮到你。