0. 前言在《C 數據操作系列 5. EF Core 入門》篇中，我們簡單的通過兩個類演示了一下EF增刪改查等功能。細心的小伙伴可能看了生成的DDL SQL 語句，在裡面發現了些端倪。沒看的小伙伴也不急，這就貼出來。 DDL SQL： 1. 映射規則通過簡單的示例，我們可以看到EF的映射規則是什 ...

0. 前言

在《C# 數據操作系列 - 5. EF Core 入門》篇中，我們簡單的通過兩個類演示了一下EF增刪改查等功能。細心的小伙伴可能看了生成的DDL SQL 語句，在裡面發現了些端倪。沒看的小伙伴也不急，這就貼出來。

public class ModelA
{
	public int Id { get; set; }
	public string Name { get; set; }
	public List<ModelB> ModelBs { get; } = new List<ModelB>();
}
public class ModelB
{
    public int Id { get; set; }
    public string Name { get; set; }
    public int ModelAId { get; set; }
    public ModelA modelA { get; set; }
}

DDL SQL：

CREATE TABLE "ModelBs" (
    "Id" INTEGER NOT NULL CONSTRAINT "PK_ModelBs" PRIMARY KEY AUTOINCREMENT,
    "Name" TEXT NULL,
    "ModelAId" INTEGER NOT NULL,
    CONSTRAINT "FK_ModelBs_ModelAs_ModelAId" FOREIGN KEY ("ModelAId") REFERENCES "ModelAs" ("Id") ON DELETE CASCADE
);
-- auto-generated definition
create table ModelAs
(
    Id   INTEGER not null
        constraint PK_ModelAs
            primary key autoincrement,
    Name TEXT
);

1. 映射規則

通過簡單的示例，我們可以看到EF的映射規則是什麼。基於約定由於配置的原則，EF把實體類當做是一個單數形式的類型描述，把表認為是實體類的集合，所以表名為類名的複數形式。

對於主鍵，預設情況下EF會檢索實體類有沒有名為Id或者類名+Id的屬性，如果有EF則認為這個屬性是主鍵，否則會認為該類沒有設置主鍵。EF檢索到主鍵的類型是數字類型的話，會自動添加自增長的約束。

對於其他屬性，EF會自動按照同名的形式映射到數據表中。

對於外鍵，如果在類里添加了引用類型，而這個引用類型也在EF的上下文中，EF會把這種屬性稱為導航屬性。EF一旦在類里檢索到了導航屬性，就會去尋找對應的外鍵。EF會認為屬性名+Id或者類名+Id 可能是外鍵屬性，如果找到名稱一致且類型與導航屬性目標類的主鍵類型一致，則認為是外鍵。如果類型不一致，EF則認為該類設置有誤。如果沒找到符合名稱要求的屬性，EF會自己添加一個外鍵屬性。

對於一對一，EF要求導航屬性雙方都應該具有外鍵配置。

一對多，EF要求多的一方設置外鍵。同時如果在一方這邊設置了集合類型的導航屬性，那麼EF會自動到目標類里尋找外鍵屬性。

說完了一對一和一對多，那麼多對多呢？

如果沒有聲明的話， EF會生成一個中間表。

2. 修改映射關係

EF允許開發人員指定自己的映射規則或者單個類的映射規則。EF 提供了幾種方式來修改映射關係。

2.1 數據註解

EF允許開發人員通過使用Attribute標記，來約定映射關係。

先引入命名空間：

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

常見的註解如下：

[Table("ModelA")]

TableAttribute 表示實體映射的哪張表

[Key]

KeyAttribute 用來標記哪個屬性是主鍵

[DatabaseGenerated(DatabaseGeneratedOption.Identity)]

用來表示這個欄位在第一次插入資料庫時，值由資料庫提供

[ForeignKey("ModelAId")]

表示該導航屬性具體值由名稱為 ModelAId 的屬性維護，如果沒有該屬性，EF則記錄添加但不對外顯示。

[InverseProperty("Author")]

用在集合類型的屬性上，表示該集合屬性是與源類哪一個導航屬性相關。

[Column]

表示列，用來設置一些列的基本參數，比如類型、名稱

[Required]

表示該列在插入資料庫時不能為空

使用註解進行相關配置相當簡單，但是這樣不可避免的需要修改模型類而且需要引入額外的命名空間，不太符合某些要求嚴格的項目，所以微軟又提供了另外一套寫法。

2.2 Fluent 方式

當我們使用這種方式的時候，會面臨一個問題：是新建一個配置類呢，還是在 EF上下文的OnModelCreating方法里統一配置呢？

我們先看一下EF上下文的OnModelCreating的聲明是什麼：

protected internal virtual void OnModelCreating(ModelBuilder modelBuilder);

這裡有一個ModelBuilder類型，查看它的API發現兩個方法：

public virtual Microsoft.EntityFrameworkCore.ModelBuilder ApplyConfiguration<TEntity> (Microsoft.EntityFrameworkCore.IEntityTypeConfiguration<TEntity> configuration) where TEntity : class;

public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder<TEntity> Entity<TEntity> () where TEntity : class;

繼續尋找 IEntityTypeConfiguration，看到這個介面只有一個方法：

void Configure(EntityTypeBuilder<TEntity> builder);

兩個都指向了 EntityTypeBuilder<TEntity> builder，而這個正是Fluent API配置類的關鍵。所以通過分析API，我們可以得到這兩種寫法。

那麼，這兩種的取捨呢？

在項目比較小，數據類很少的時候，可以直接在OnModelCreating里寫。否則，更建議繼承一個Configuration介面。

那麼，我們就來看看通過builder怎麼配置映射關係吧：

public class ModelEntityConfig : IEntityTypeConfiguration<ModelA>// 基於 ModelA新建一個配置類
{
    public void Configure(EntityTypeBuilder<ModelA> builder)
    {
    }
}

builder.ToTable("TableName");

設置表名

builder.HasKey(t => t.Id);
//builder.HasKey(t => t.Id).HasName("KeyName");

設置主鍵，如果不寫後面的HasName，則主鍵名稱預設是屬性名；寫了之後EF將使用聲明的名稱作為主鍵在資料庫的名稱。

var property = builder.Property(t => t.Name);

獲取一個與屬性Name相關聯的PropertyBuilder實例，通過這個實例可以配置屬性與資料庫列的關係。

builder.Ignore(t => t.ModelBs);

表示這個屬性不由資料庫維護。

回過頭來，我們看看 PropertyBuilder里有哪些方法：

// 設置一個最大長度
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasMaxLength (int maxLength);
// 設置一個數據生成規則
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator (Func<Microsoft.EntityFrameworkCore.Metadata.IProperty,Microsoft.EntityFrameworkCore.Metadata.IEntityType,Microsoft.EntityFrameworkCore.ValueGeneration.ValueGenerator> factory);
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator (Type valueGeneratorType);
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator<TGenerator> () where TGenerator : Microsoft.EntityFrameworkCore.ValueGeneration.ValueGenerator;

// 設置在添加時，自動生成一個值
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder ValueGeneratedOnAdd ();
//設置列名
public static Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasColumnName (this Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder propertyBuilder, string name);
// 設置列的資料庫參數類型
public static Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasColumnType (this Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder propertyBuilder, string typeName);

3. 總結

在這一篇領著大家看了一下EF Core對於映射關係這一部分的內容，我留下了外鍵相關的FluentAPI介紹，我打算在下一篇介紹。因為這部分的內容比較麻煩，而且使用率也相當高。

更多內容煩請關註我的博客《高先生小屋》

file

C# 數據操作系列 - 6 EF Core 配置映射關係