实体的配置
约定配置
主要规则:
1:表名采用DbContext中的对应的DbSet的属性名。
2:数据表列的名字采用实体类属性的名字,列的数据类型采用和实体类属性类型最兼容的类型。
3:数据表列的可空性取决于对应实体类属性的可空性。
4:名字为Id的属性为主键,如果主键为short,int 或者long类型,则默认采用自增字段,如果主键为Guid类型则默认采用默认的Guid生成机制生成主键值。
两种配置方式
l、Data Annotation把配置以特性 (Annotation)的形式标注在实体类中。
[Table(“T_Books”)]
public class Book
优点:简单;缺点:耦合。
2、Fluent API 【推荐】
builder.ToTable(“T_Books”);
把配置写到单独的配置类中。
缺点:复杂;优点:解耦
3、大部分功能重叠。可以混用,但是不建议混用
示例:
1.新建 Cat 类
2.将类信息加到 Dbcontext 中
3.添加特性
执行编译和运行命令:
表 生成成功
使用Fluent API 的好处是可以根据实际情况,修改代码结构 ,生成不同类型表名,字段等。 可定制化性 提高
Fluent API 1
只过一遍,不演示
1、视图与实体类映射:
modelBuilder.Entity(.ToView(“blogsView”);
2、排除属性映射:(让某个属性,不映射到表中)
modelBuilder.Entity().lgnore(b => b. Name2);
3、配置列名:(将某个字段改为自己想要的名字)
modelBuilder.Entity().Property(b=>b.BlogId).HasColumnName(“blog_id”);
4、配置列数据类型:
builder.Property(e => e.Title) .HasColumnType(“varchar(200)”)
5、配置主键
默认把名字为Id或者“实体类型+Id“的属性作为主键,可以用HasKey()来配置其他属性作不演示映射: modelBuilder.Entity().HasKey(c=>c.Number);
支持复合主键,但是不建议使用
增加 Name2字段
执行:
Fluent API 2
6、生成列的值
modelBuilder.Entity().Property(b =>b.Number).ValueGeneratedOnAdd();
7、可以用HasDefaultValue0为属性设定默认值modelBuilder.Entity().Property(b =>b.Age).HasDefaultValue(6);
8、索引
modelBuilder.Entity().HasIndex(b => b.Url);
复合索引modelBuilder.Entity().HasIndex(p => new { p.FirstName,p.LastName});唯一索引: IsUnique0; 聚集索引: IsClustered()
9… 用EF Core太多高级特性的时候谨慎,尽量不要和业务逻辑混合在一起,以免“不能自拔”。比如Ignore、Shadow、Table Splitting等…
EFCORE Fluent API 其他
Fluent API众多方法
Fluent API中很多方法都有多个重载方法。比如HasIndexProperty().把Number属性定义为索引,下面两种方法都可以:
builder.HasIndex(“Number”);
builder.HasIndex(b=>b.Number);
推荐使用HasIndex(b=>b.Number)、Property(b => b.Number)这样的写法因为这样利用的是C#的强类型检查机制(字符串的方式,无法判断语法错误)
选择
1、Data Annotation 、Fluent API大部分功能重叠。可以混用但是不建议混用。
2、有人建议混用,即用了Data Annotation 的简单,又用到Fluent API的强大,而且实体类上标注的[MaxLength(50)][Required]等标注可以被ASPNET Core中的验证框架等复用。我为什么不建议混用。
3、我和业界很多人都倾向只使用Fluent API。本课以讲解FluentAPI为主(尽量用约定),如果项目强制用Data Annotation 请翻文档,知识都是通用的。