1.4.3 键（主键）

键被作为每个实体实例主要唯一标识。当使用的是关系数据库时，键被映射为主键这个概念。你还可以将唯一标识配置为非主键（详见 替代键（备用关键字））。

惯例

按照惯例，名为 Id 或者 <当前类型名称>Id 的属性都将被配置为实体的键。

class Car
{
    public string Id { get; set; }

    public string Make { get; set; }
    public string Model { get; set; }
}

class Car
{
    public string CarId { get; set; }

    public string Make { get; set; }
    public string Model { get; set; }
}

数据注解

可以使用数据注解将单一属性配置为实体的键。

class Car
{
    [Key]
    public string LicensePlate { get; set; }

    public string Make { get; set; }
    public string Model { get; set; }
}

流式 API

可以使用流式 API 将单一属性配置为实体的键。

class MyContext : DbContext
{
    public DbSet<Car> Cars { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Car>()
            .HasKey(c => c.LicensePlate);
    }
}

class Car
{
    public string LicensePlate { get; set; }

    public string Make { get; set; }
    public string Model { get; set; }
}

还可以使用流式 API 将多个属性配置为实体的键（通常被称为组合件）。组合件只能通过流式 API 来配置 - 惯例不会设置组合件，数据注解也无法配置组合键。

class MyContext : DbContext
{
    public DbSet<Car> Cars { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Car>()
            .HasKey(c => new { c.State, c.LicensePlate });
    }
}

class Car
{
    public string State { get; set; }
    public string LicensePlate { get; set; }

    public string Make { get; set; }
    public string Model { get; set; }
}