温馨提示×

温馨提示×

您好,登录后才能下订单哦!

密码登录×
登录注册×
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》

C# 中SqlSugar如何使用

发布时间:2021-07-15 11:04:15 来源:亿速云 阅读:924 作者:Leah 栏目:大数据

这篇文章给大家介绍C# 中SqlSugar如何使用,内容非常详细,感兴趣的小伙伴们可以参考借鉴,希望对大家能有所帮助。

1. 花式映射

在实际开发中,程序中的实体类和数据库的表名并不能完全一致,造成的原因有很多,例如说团队对数据库的命名和对程序的命名有着不同的要求,数据库是先建立的而程序是后开发的,又或者是程序只使用了数据库中一部分表等等。

这时候就会与C#约定优于配置相违背,但是这也符合C#的设计哲学,因为配置也是C#的一部分。我们该如何从实际角度来完成表与实体类之间的关系建立呢?

那就让我来带着大家一起看看SqlSugar是否能优雅的完成这一部分:

 

1.1 Attribute设置

SqlSugar预制了一些Attribute,允许我们通过Attribute来为实体表与数据库表之间建立关系:

  • SugarTable:用来定义实体类映射的数据表

public SugarTable(string tableName);
public SugarTable(string tableName, string tableDescription);
 

这是SugarTable的两个构造函数,允许设置表名和数据表描述

  • SugarColumn:用来定义属性与数据表中的列的关系

public string ColumnDataType { get; set; }// 列的数据类型,填SQL 的数据类型
public string OldColumnName { get; set; }// 当做了表更新之后,用来生成数据库用,此处填写原列名
public bool IsNullable { get; set; }// 设置列是否允许为NULL
public int Length { get; set; } // 设置列的数据长度
public string ColumnDescription { get; set; }// 设置列的描述名称
public bool IsIdentity { get; set; }         // 设置该列是否是自增列
public bool IsPrimaryKey { get; set; }        //设置该列是主键
public bool IsIgnore { get; set; }            // 不作数据库操作,true将不会进行查询、添加等操作
public string ColumnName { get; set; }        // 设置对应的列名
public string DefaultValue { get; set; }    // 设置该列的默认值
 

SqlSugar的Attribute配置非常的简单,只需要针对类与表的映射和属性对列的映射做出配置即可。

 

1.2 动态配置

与EF等一样,SqlSugar也支持动态配置,那么就跟着我一起去看看,如何实现动态配置吧:

SqlSugar支持的动态配置功能较少,最好是预先设计好了数据库,然后使用动态配置做好关联。

通过SugarClient设置数据表的动态配置:

Client.MappingTables.Add
 

方法有:

public void Add(string entityName, string dbTableName);
public void Add(string entityName, string dbTableName, string dbTableShortName);
public void Add(MappingTable table);
 

然后通过SugarClient设置列的动态配置:

Client.MmappingColumn.Add
 

方法有:

public void Add(string propertyName, string dbColumnName, string entityName);
public void Add(MappingColumn col);
 

显然,动态配置并不支持设置列的其他内容。当然,SugarClient还可以配置忽略字段:

Client.IgnoreColumns.Add
 

具体实现方法如下:

public void Add(string propertyName, string EntityName);
publiv void Add(IgnoreColumn col);
   

1.3 As 别名模式

SqlSugar在增删改查的时候,为数据实体添加了别名处理,使用方法As(string newName)即可。

Queryable<T>().As("newName")   //select * from newName
Insertable
Updateable
Deleteable
 

类似与SQL的别名查询

 

2. 外键关联

SqlSugar中并没有设置导航属性的正式加载,而是添加了一个Mapper方法:在查询的时候,调用Mapper映射外键关系,以达到导航属性一起加载的功能。

首先需要注意的是,在SqlSugar中导航属性需要配置为忽略,避免被直接解析为SQL,否则会提示Sequence contains no elements

添加几个示例类:

[SugarTable("P_Person")]
public class Person
{
   [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
   public int Id { get; set; }
   public string Name { get; set; }
   public int Age { get; set; }
   /// <summary>
   /// 忽略
   /// </summary>
   [SugarColumn(IsIgnore = true)]
   public Employee Employee { get; set; }
}

public class Employee
{
   [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
   public int Id { get; set; }
   public string Name { get; set; }
   public int PersonId { get; set; }
   [SugarColumn(IsIgnore = true)]
   public Person Person { get; set; }
   public int DeptId{get;set;}
   [SugarColumn(IsIgnore = true)]
   public Dept Dept{get;set;}
}

public class Dept
{
   [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
   public int Id { get; set; }
   public string Name { get; set; }
   [SugarColumn(IsIgnore = true)]
   public List<Employee> Employees{get;set;}
}
 

使用上一篇的Context类:

public class DefaultContext
{
   public SqlSugarClient Client { get; }

   public DefaultContext(string connectionString, DbType dbType)
   {
       Client = new SqlSugarClient(new ConnectionConfig
       {
           ConnectionString = connectionString,//"Data Source=./demo.db",
           DbType = dbType,
           IsAutoCloseConnection = true,
           InitKeyType = InitKeyType.Attribute
       });
       // == 新增

       Client.CodeFirst.InitTables<Person, Employee, Dept>();
       Client.Aop.OnLogExecuting = (sql, paramters) =>
       {
           Console.WriteLine(sql);
       };
   }
}
 

简单介绍一下,

InitTables这个方法,SqlSugar提供了很多重载版本,但推荐使用以下三个:

void InitTables(string entitiesNamespace);
void InitTables(string[] entitiesNamespaces);
void InitTables(params Type[] entityTypes);
 

前两个,可以约定实体类的命名空间,然后一次性初始化所有实体类。第三个初始化传入的实体类类型实例,也可以 根据一定规则反射遍历出需要的类。

OnLogExecuting是SqlSugar 的一个监听事件(虽然它不是事件,但我个人觉得写成事件模式比较好),作用是监控框架执行的SQL语句,可以用来调试或者做日志监控等。

使用Mapper查询一对一映射类型:

var results = context.Client.Queryable<Employee>().Mapper(t=>t.Person, p=>p.PersonId).ToList();
 

使用Mapper查询一对多映射类型:

var results = context.Client.Queryable<Dept>().Mapper(p => p.Employees, p => p.Employees.First().DeptId).ToList();
 

需要注意的是,这两个是固定写法。

其中,一对一要求必须从主对象开始查询。所谓主对象就是必须持有一个外键指向另一个表。

一对多要求从拥有集合属性的那段(也就是其中的“一”)开始,关联指示为 集合.First().外键 。

还有一点就是SqlSugar的导航属性必须手动加载,不会自动加载进来,所以完全不会出现深度递归的问题。


关于C# 中SqlSugar如何使用就分享到这里了,希望以上内容可以对大家有一定的帮助,可以学到更多知识。如果觉得文章不错,可以把它分享出去让更多的人看到。

向AI问一下细节

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

AI