像以上这种情况，很明显A，B之间有着一一对应的关系，因此EFCore会将A和B都作为模型实体进行加载，而并不会因为B未声明而不加载。

通过OnModelCreating声明

我们也可以通过重写OnModelCreating声明一个模型类，例如

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
    // 指定模型
    modelBuilder.Entity();
}

综上所述，EFCore对模型的查找是只要有所提及，无论是显示的利用DbSet或是利用导航属性，亦或是在OnModelCreating中有所提及，都会被作为模型类进行操作。不过在这里，除非是你非常不需要显示声明，否则，建议使用DbSet进行显示声明，避免对开发带来不必要的麻烦。

不过有时候我们不希望我们模型和数据库对应，因为有些模型只是为了辅助存在或作为一个子属性存在，在数据库中并不存在这个表，那么我们可以使用 [NotMapped] 标记，这样该类就不会被EFCore所识别为模型。

示例代码

前文中我们提到了一个学生选课系统的概念模型，这里我们进行一个原始的建库操作。这里会交叉使用FluentApi和Attribute的方式进行书写以方便读者理解。

首先我们建立简单的领域模型

public enum Gender
{
    Male,
    Female
}

[Table("Test_Student")]
public class Student
{
    public int Id { get; set;}
    public string Name { get; set; }
    public Gender Gender { get; set; }
    public string Remark { get; set; }
    public string StudentId{ get; set; }
}

[Table("Test_Teacher")]
public class Teacher
{
    public int Id {get;set;}
    public string Name { get;set; }
    public Gender Gender { get; set; }
    public string Remark { get; set; }
}

public class Course
{
    public int Id {get;set;}
    public string Name {get;set;}
    public string CourseId{ get; set; }
}
public class Context : DbContext
{
    public virtual DbSet Students { get; set;}
    public virtual DbSet Teachers { get; set;}
    public virtual DbSet Courses { get; set;}
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity().ToTable("Test_Student");
    }
}

这样我们就大概做好了一个简单的数据库框架，不过这个数据模型是不符合我们实际设计的模型的，这里只作为讲解作用，并不作为实际项目的设计。

属性类型和转换

光有表设置显然是不够的，我们还需要对表中的字段和属性进行设置。表中的字段，如果是非引用类型，都会被识别成数据库中的列，引用类型在表中通常会作为导航属性存在。按照约定，具有getter和setter的所有公共属性都将包括在模型中映射到表中的列。接下来仍然会分为FluentApi和Attribute进行编写。

在数据库中，我们对一个列的常见操作通常就是操作列名、列类型、排序规则、可空等。这里进行一个归纳和整理

属性类型示例

这里先用数据注解Attribute的方式进行操作，限于篇幅，在此仅对一个类进行操作，读者可根据自己需求对其他类进行编写。

[Table("Test_Student")]
public class Student
{
    public int Id { get; set;}
    //属性不能为空
    [Required]
    // 列名，排序顺序，列类型
    [Column(name:"Name",Order =1,TypeName ="varchar(25)")]
    //等效于[Column(name:"",Order =1,TypeName ="varchar(25)"),Required]
    //属性后接等号就是默认值的设置方法
    public string Name { get; set; } = "abcd";
    public Gender Gender { get; set; }
    // 也可以通过设置maxLength属性进行限制长度
    [Column("Remark"),MaxLength(150)]
    public string Remark { get; set; }
    public string StudentId{ get; set; }
}

设置可空类型则是在类型后加？号，但是通过数据标注的方式进行设置的方法作者查阅了文档和资料并没有发现，只有FluentApi可以设置。应该是微软直接默认就是空，因此无需指定设置。

这里是FluentApi的方式

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity().ToTable("Test_Student");
        modelBuilder.Entity().Property(p => p.Name)
            //非空
            .IsRequired()
            //列名
            .HasColumnName("Name")
            //列类型
            .HasColumnType("varchar(25)")
            //默认值
            .HasDefaultValue("");
        modelBuilder.Entity().Property(p => p.Remark)
            //可空
            .IsRequired()
            //列名
            .HasColumnName("Remark")
            //可使用.IsFixedLength()设置为定长
            //列最大长度
            .HasMaxLength(150);
    }

值映射转换

值转换提供了在写入数据库前的一次数据处理，试想一下，假如你不希望将加密过程放在业务层，或者说你习惯用枚举去存储一些值，但是在数据库中实际需要使用枚举名而不是枚举值，那么我们就需要进行值映射转换。

值转换只在FluentApi中提供，我们可以在OnModelCreating中进行定义，例如：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity().Property(p => p.Gender)
        .HasConversion(
            p => p.ToString(),
            p => (Gender)Enum.Parse(typeof(Gender), p));
}

在这里，第一个lambda表达式表示你的模型出，第二个则是数据库映射回你的模型类所需的处理。你也可以使用ValueConverter类来定义，例如：

var converter = new ValueConverter(
    p => p.ToString(),
    p => (Gender)Enum.Parse(typeof(Gender), p));

将此对象传入HasConversion方法亦可。

键与索引

键是数据库最精华的部分了，键又被成为码，是关系模型的重要概念，它是数据库的逻辑部分，并不是数据库的物理结构。通常情况下，键（非外键）时不可以被重复的。

主键和备用（候选）键

主键用于唯一标识一条数据，在我们的数据库教程中讲到，主键可以是一个值，也可以是组合值。

候选键有两个要求：始终能够确保在关系中能唯一标识元组；在属性集中找不出真子集能够满足条件。其中第一个条件就是超键的标准，所以我们可以把候选键理解为不能再“缩小”的超键。

这里我们依旧使用两种方式进行编写。

索引

索引可以理解为书籍的目录，这将会是数据库的查询更加快速，默认情况之下，索引并不唯一。索引不能使用数据批注创建索引，可以使用FluentApi按如下方式为配置指定索引：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Entity()
        .HasIndex(p=>p.StudentId)
}

当然，如果有需要，你也可以对多个列进行索引定义，并且可以指定索引的名称，同时可以将索引修改成唯一值：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Entity()
        .HasIndex(p=>new {p.Name,p.StudentId})
        .HasName("Test")
        .IsUnique();
}

索引也有一些较为高级的用法，例如索引过滤器以及索引包含列。

过滤器可以对索引进行筛选，只针对部分数据建立索引，从而减少对硬盘空间的需求，如下所示：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Entity()
        .HasIndex(p=>p.StudentId)
        .HasFilter("[StudentId] IS NOT NULL");
}

包含列是某些关系数据库允许配置一组列，这些列包含在索引中，但不是其的一部分。 当查询中的所有列都作为键列或非键列包含在索引中时，这可以显著提高查询性能，因为表本身无需访问。例如：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Entity()
        .HasIndex(p=>p.StudentId)
        .IncludeProperties(p=>new {p.Name});
}

对于上面的内容，你使用StudentId的时候可以便捷的使用整个索引，但是当你仅需要访问Name时，便不会加载索引，这样对整体的性能有显著的提高。

从属实体（值实体）与无键实体

从属实体

从属实体就是一个属性集合，但是它并不作为一个完整的实体存在，它是所有者的一部分。例如你的家庭住址信息，它并不适合在你的个人信息表中存在，如果将其放置在你的个人信息表中，会使得你的表过于冗余。如果没有实体，从属实体是毫无意义的。并且通常而言从属实体并不唯一且从属实体的状态并不一定实时随实体改变，举个例子，点外卖的时候，你的个人信息和你的收货地址的关系就是一个实体和从属实体的关系，你下单时的地址和你修改了收获地址时没有关系的，并且对于地址而言，倘若脱离了个人信息时毫无意义的。

使用从属实体可以用数据标签（EF Core>2.1）和FluentApi的方式，这里引用官方文档的例子：

[Owned]
public class StreetAddress
{
    public string Street { get; set; }
    public string City { get; set; }
}
public class Order
{
    public int Id { get; set; }
    public StreetAddress ShippingAddress { get; set; }
}
//或者
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity().OwnsOne(p => p.ShippingAddress);
    //倘若ShippingAddress是私有属性，则可以使用以下
    modelBuilder.Entity().OwnsOne(typeof(StreetAddress), "ShippingAddress");
}

无键实体

无键实体就很简单了，就是没有主键的实体，但是和从属实体是有区别的，假如有一个表是记录各个班级人数的表，那么它其实就不是那么需要主键。定义如下：

[Keyless]
public class ClassCount
{
    public string Name { get; set; }
    public int Count { get; set; }
}
// 或
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity()
        .HasNoKey();
}

无键实体也不一定对应一张实体表，也有可能是一个视图等这种没有主键的数据。它们不同于常规实体类型，因为它们：

• 不能定义键
• 永远不会对DbContext中的更改进行跟踪，因此不会在数据库中插入、更新或删除这些更改，你需要手动调用对应方法进行操作。
• 绝不会按约定发现。
• 仅支持导航映射功能的子集，具体如下：
  • 它们永远不能充当关系的主体端
  • 它们可能没有到拥有的实体的导航
  • 它们只能包含指向常规实体的引用导航属性
  • 实体不能包含无键实体类型的导航属性

隐藏(Shadow)属性与自动生成属性

隐藏(Shadow)属性

隐藏属性就是在数据库生成时，你在类中未定义却在表中出现的一些属性。例如你定义了外键导航属性却并未定义外键属性，那么EF会生成一个自动的属性去做外键关系。同时还有主键，EF默认一切实体都有主键，即使你不定义主键，EFCore也会生成一个自增的Id作为表的主键。

有时候隐藏属性也可以是你未映射到类中的列，或者你也可以用以下方法设定隐藏属性:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Entity()
        .Property("LastUpdated");
}

访问隐藏属性则通过EF的拓展方法进行访问，如下：

context.Entry(student).Property("LastUpdated").CurrentValue = DateTime.Now;
//或在Linq
var blogs = context.Student
    .OrderBy(b => EF.Property(b, "LastUpdated"));

自动生成属性

自动生成属性就是分为两种，在添加数据时自动生成值或在数据是更新值。

在添加、更新时生成值可以使用数据注释和FluentApi定义，具体如下：

public class Student
{
    //自增
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    //[DatabaseGenerated(DatabaseGeneratedOption.Computed)] 在更新时生成
    public int Id { get; set;}
}
// 或
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity()
        .Property(b => b.Id)
        .ValueGeneratedOnAdd();
}

我们还可以设置计算列，有些列需要在更新或添加时通过表中的数据进行计算，那么我们可以使用fluentApi进行实现：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity()
        .Property(p => p.DisplayName)
        .HasComputedColumnSql("[LastName] + ', ' + [FirstName]");
}

我们也可以配置一些默认值，直接对类中属性进行操作也没有问题，但是也可以使用FluentApi的方法：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity()
        .Property(b => b.EditTime)
        .HasDefaultValueSql("getdate()");
}

关系型数据

关系型数据库是目前数据库的主流，同时，在绝大多数数据库的设计上，都会涉及到表之间的关系。

一对一

一对一关系就是A表中的一条数据和B表中的一条数据是一一对应关系，例如一个人的身份证和他的社保就是一种一一对应给的关系。在EF中进行配置的时候，我们需要在A，B表中定义相关的导航属性，并且设置好相关的外键，在配置的时候需要设置好外键所在的类，例如：

如果你不指定外键，EFCore会默认生成一条外键的隐藏属性。

一对多

一对多关系就类似于学生和班级，一个学生只有一个班级，但是一个班级有许多学生，配置方法和一对一类似，但是值得注意的是，外键始终在“一”的那个表中。

多对多

多对多的关系就不展开赘述，简要提一句，多对多关系是无法通过EF配置的，我们需要引入一个中间表，将关系转化成和中间表的一对多关系就可以曲线救国实现多对多关系。

数据库迁移

数据库的迁移就是将你的类数据迁移至数据库转换为表数据，这里你需要安装dotnet-ef或Nuget包"Microsoft.EntityframeworkCore.Tools、Microsoft.EntityframeworkCore.Design"，并且配置好DbContext。使用包管理控制台或普通控制台。

Nuget包管理控制台:

Add-Migrations [name]
Update-Database

普通控制台使用dotnet-ef

dotnet ef migration add [name]
dotnet ef database update

如果你的类配置完全正确，那么你所连接的数据库将会自动的生成你的表数据。

分散配置关系型数据库

有时候我们的表的配置会非常多，并且数据库所需要配置的表又非常多的时候，我们最好使用一个单独的类进行配置各个表，使得代码可读性、维护性更高，我们需要创建一个类去继承EF的配置接口，例如：

public class TestMap : IEntityTypeConfiguration
{
    public void Configure(EntityTypeBuilder builder)
    {
    }
}

这样你就可以在不同的类中进行数据库的配置了。

更多内容请关注我的BiliBili地址以及我的博客。

Github

BiliBili主页

WarrenRyan's Blog

博客园