【EF Core】自动生成的字段值-数字星空

自动生成字段值，咱们首先想到的是主键列（带 IDENTITY 的主键）。EF Core 默认的主键配置也是启用 Identity 自增长的，而且可以自动标识主键。前提是代表主键的实体属性名要符合以下规则：

1、名字叫 ID、id、或 Id，就是不分大小写；

2、名字由实体类名 + Id 构成。比如，Car 实体类，包含一个属性叫 CarID 或 CarId；

3、属性类型是整数类型（int、long、ushort 等，但不是 byte）或 GUID。

这些识别主键的规则是由一种叫“约定”（Convension）的东西实现的，具体来说，是一个叫 KeyDiscoveryConvention 的类。老周放一小段源代码给各位瞧瞧。

public class KeyDiscoveryConvention :
    IEntityTypeAddedConvention,
    IPropertyAddedConvention,
    IKeyRemovedConvention,
    IEntityTypeBaseTypeChangedConvention,
    IEntityTypeMemberIgnoredConvention,
    IForeignKeyAddedConvention,
    IForeignKeyRemovedConvention,
    IForeignKeyPropertiesChangedConvention,
    IForeignKeyUniquenessChangedConvention,
    IForeignKeyOwnershipChangedConvention,
    ISkipNavigationForeignKeyChangedConvention
{
    private const string KeySuffix = "Id";

    ……

    public static IEnumerable<IConventionProperty> DiscoverKeyProperties(
        IConventionEntityType entityType,
        IEnumerable<IConventionProperty> candidateProperties)
    {
        Check.NotNull(entityType, nameof(entityType));

        // ReSharper disable PossibleMultipleEnumeration
        var keyProperties = candidateProperties.Where(p => string.Equals(p.Name, KeySuffix, StringComparison.OrdinalIgnoreCase));
        if (!keyProperties.Any())
        {
            var entityTypeName = entityType.ShortName();
            keyProperties = candidateProperties.Where(
                p => p.Name.Length == entityTypeName.Length + KeySuffix.Length
                    && p.Name.StartsWith(entityTypeName, StringComparison.OrdinalIgnoreCase)
                    && p.Name.EndsWith(KeySuffix, StringComparison.OrdinalIgnoreCase));
        }

        return keyProperties;
        // ReSharper restore PossibleMultipleEnumeration
    }
   ……
}

这几个逻辑 And 其实就是查找 <类名>Id 格式的属性名，如 StudentID、CarId、OrderID…… 外键的发现原理也跟主键一样。

用 Sqlite 数据举一个简单的例子。下面是实体类（假设它用来表示输入法信息）：

public class InputMethod
{
    public ushort RecoId { get; set; }
    public string? MethodDisplay { get; set; }
    public string? Description { get; set; }
    public string? Culture { get; set; }
}

如你所见，这个类作为主键的属性是 RecoId，但是，它的命名是无法被自动识别的，咱们必须明确地告诉 EF，它是主键。方法有二：

1、批注法。直接在属性上应用相关的特性类。如

public class InputMethod
{
    [Key]
    public ushort RecoId { get; set; }
    ……
}

2、重写 DbContext 类的 OnModelCreating 方法。如

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<InputMethod>().HasKey(e => e.RecoId);
}

如果使用了上面重写 OnModelCreating 方法，那么，你的 DbContext 派生类已经能识别 InputMethod 实体类了。但如果你用的是在属性上应用 [Key] 特性的方式，那么 DbContext 的派生类是识别不到实体类的，你需要将它的集合声明为 DbContext 的属性。

internal class TestDBContext : DbContext
{
    // 构造函数
    public TestDBContext(DbContextOptions<TestDBContext> opt)
        : base(opt)
    { }

    // 将实体集合声明为属性
    public DbSet<InputMethod> InputMethods { get; set; }
}

注意，数据记录的集合要用 DbSet<>，其他类型的集合是不行的哟。比如，你改成这样，就会报错。

public List<InputMethod> InputMethods { get; set; }

说明人家只认 DbSet 集合，其他集合无效。

这里老周选用服务容器来配置。

static void Main(string[] args)
{
    IServiceCollection services = new ServiceCollection();
    // 构建连接字符串
    SqliteConnectionStringBuilder constrbd = new();
    constrbd.DataSource = "abc.db";
    // 添加 Sqlite 功能
    services.AddSqlite<TestDBContext>(
            connectionString:    constrbd.ToString(),
            optionsAction:       dcopt =>
            {
                dcopt.LogTo(msg => Console.WriteLine(msg), LogLevel.Information);
            }
        );
    // 生成服务列表
    var svcProd = services.BuildServiceProvider();
    if(svcProd == null)
    {
        return;
    }

    // 访问数据上下文
    using TestDBContext dbc = svcProd.GetRequiredService<TestDBContext>();
    ……
}

连接字符串你可以直接用字符串写，不用 ConnectionStringBuilder。默认的 SQLite 库是不支持密码的，所以老周就不设置密码了。在调用 AddSqlite 方法时，有一个名为 optionsAction 的参数，咱们可以用它配置日志输出。LogTo 方法配置简单，只要提供一个委托，它绑定的方法只要有一个 string 类型的输入参数就行，这个字符串参数就是日志文本。

配置日志功能后，运行程序时，控制台能看到执行的 SQL 语句。

下面咱们来创建数据库，然后插入两条 InputMethod 记录。

// 访问数据上下文
using TestDBContext dbc = svcProd.GetRequiredService<TestDBContext>();
// 删除数据库
dbc.Database.EnsureDeleted();
// 创建数据库
dbc.Database.EnsureCreated();

// 尝试插入两条记录
InputMethod[] ents = [
        new(){MethodDisplay = "双拼输入", Description="按两个键完成一个音节",Culture="zh-CN"},
        new() {MethodDisplay = "六指输入", Description="专供六个指头的人使用",Culture="zh-CN"}
    ];
dbc.Set<InputMethod>().AddRange(ents);
int result = dbc.SaveChanges();
Console.WriteLine($"更新记录数：{result}");

// 打印插入的记录
foreach(InputMethod im in dbc.Set<InputMethod>())
{
    Console.WriteLine($"ID={im.RecoId}, Display={im.MethodDisplay}, Culture={im.Culture}");
}

这里是为了测试，调用了 EnsureDeleted 方法，实际应用时一般不要调用。因为这个方法的功能是把现存的数据库删除。如果调用了此方法，那应用程序每次启动都会删掉数据库，那用户肯定会投诉你的。EnsureCreated 方法可以使用，它的功能是如果数据库不存在，就创建新数据库；如果数据库存在，那啥也不做。所以，调用 EnsureCreated 方法不会造成数据丢失，放心用。

插入数据和调用 SaveChanges 方法保存到数据库的代码，相信大伙都很熟了，老周就不介绍了。

程序运行之后，将得到这样的日志：

info: 2024/8/4 12:48:11.517 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (10ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      PRAGMA journal_mode = 'wal';
info: 2024/8/4 12:48:11.582 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      CREATE TABLE "tb_ims" (
          "RecoId" INTEGER NOT NULL CONSTRAINT "PK_tb_ims""MethodDisplay""Description""Culture" TEXT NULL
      );
info: 2024/8/4 12:48:11.700 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (3ms) [Parameters=[@p0='?' (Size = 5), @p1='?' (Size = 10), @p2='?' (Size = 4)], CommandType='Text', CommandTimeout='30']
      INSERT INTO "tb_ims" ("Culture", "Description", "MethodDisplay")
      VALUES (@p0, @p1, @p2)
      RETURNING "RecoId";
info: 2024/8/4 12:48:11.712 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (0ms) [Parameters=[@p0='?' (Size = 5), @p1='?' (Size = 10), @p2='?' (Size = 4)], CommandType='Text', CommandTimeout='30']
      INSERT INTO "tb_ims" ("Culture", "Description", "MethodDisplay")
      VALUES (@p0, @p1, @p2)
      RETURNING "RecoId";
更新记录数：2
info: 2024/8/4 12:48:11.849 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      SELECT "t"."RecoId", "t"."Culture", "t"."Description", "t"."MethodDisplay"
      FROM "tb_ims" AS "t"
ID=1, Display=双拼输入, Culture=zh-CN
ID=2, Display=六指输入, Culture=zh-CN

这样你会发现，对于整数类型的主键，默认是自动生成递增ID的。注意，这个是由数据库生成的，而不是 EF Core 的生成器。不同数据库的 SQL 语句会有差异。

为了对比，咱们不防改为 SQL Server，看看输出的日志。

// 构建连接字符串
SqlConnectionStringBuilder constrbd = new();
constrbd.DataSource = ".\\SQLTEST";
constrbd.InitialCatalog = "CrazyDB";
constrbd.IntegratedSecurity = true;
// 不信任服务器证书有时候会连不上
constrbd.TrustServerCertificate = true;
// 可读可写
constrbd.ApplicationIntent = ApplicationIntent.ReadWrite;

// 添加 SQL Server 功能
services.AddSqlServer<TestDBContext>(
        connectionString: constrbd.ToString(),
        optionsAction: opt =>
        {
            opt.LogTo(logmsg => Console.WriteLine(logmsg), LogLevel.Information);
        });

其他代码不变，再次运行。输出的日志如下：

info: 2024/8/4 13:01:06.087 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (115ms) [Parameters=[], CommandType='Text', CommandTimeout='60']
      CREATE DATABASE [CrazyDB];
info: 2024/8/4 13:01:06.122 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (31ms) [Parameters=[], CommandType='Text', CommandTimeout='60']
      IF SERVERPROPERTY('EngineEdition') <> 5
      BEGIN
          ALTER DATABASE [CrazyDB] SET READ_COMMITTED_SNAPSHOT ON;
      END;
info: 2024/8/4 13:01:06.137 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (5ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      SELECT 1
info: 2024/8/4 13:01:06.181 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (10ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      CREATE TABLE [tb_ims] (
          [RecoId] int NOT NULL IDENTITY,
          [MethodDisplay] nvarchar(12) NOT NULL,
          [Description] nvarchar(max) NULL,
          [Culture] nvarchar(max) NULL,
          CONSTRAINT [PK_tb_ims] PRIMARY KEY ([RecoId])
      );
info: 2024/8/4 13:01:06.317 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (30ms) [Parameters=[@p0='?' (Size = 4000), @p1='?' (Size = 4000), @p2='?' (Size = 12), @p3='?' (Size = 4000), @p4='?' (Size = 4000), @p5='?' (Size = 12)], CommandType='Text', CommandTimeout='30']
      SET IMPLICIT_TRANSACTIONS OFF;
      SET NOCOUNT ON;
      MERGE [tb_ims] USING (
      VALUES (@p0, @p1, @p2, 0),
      (@p3, @p4, @p5, 1)) AS i ([Culture], [Description], [MethodDisplay], _Position) ON 1=0
      WHEN NOT MATCHED THEN
      INSERT ([Culture], [Description], [MethodDisplay])
      VALUES (i.[Culture], i.[Description], i.[MethodDisplay])
      OUTPUT INSERTED.[RecoId], i._Position;
更新记录数：2
info: 2024/8/4 13:01:06.438 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (2ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      SELECT [t].[RecoId], [t].[Culture], [t].[Description], [t].[MethodDisplay]
      FROM [tb_ims] AS [t]
ID=1, Display=双拼输入, Culture=zh-CN
ID=2, Display=六指输入, Culture=zh-CN

A、使用 Sqlite 数据库时，生成的 CREATE TABLE 语句，主键列是 PRIMARY KEY AUTOINCREMENT；

B、使用 SQL Server 时，主键列使用的是 IDENTITY，默认以 1 为种子，增量是 1。所以插入记录的键值是1和2。

有时候我们并不希望主键列自动生成值，同样有两种配置方法：

1、通过特性类来批注。如

public class InputMethod
{
    [Key, DatabaseGenerated(DatabaseGeneratedOption.None)]
    public ushort RecoId { get; set; }
    public string? MethodDisplay { get; set; }
    public string? Description { get; set; }
    public string? Culture { get; set; }
}

将 DatabaseGeneratedOption 设置为 None，就取消列的自动生成了。

2、通过模型配置，即重写 OnModelCreating 方法实现。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<InputMethod>().HasKey(e => e.RecoId);
    modelBuilder.Entity<InputMethod>()
        .Property(k => k.RecoId)
        .ValueGeneratedNever();
}

这种情况下，插入数据时主键列就需要咱们手动赋值了。

======================================================================================

上面的是热身运动，是比较简单的应用方案。下面老周给大伙伴解决一个问题。老周看到在 GitHub 等平台上有人提问，但没有得到解决。如果你看到老周这篇水文并且你有此困惑，那你运气不错。好，F话不多说，咱们看问题。

需求：主键不变，但是我不想让它带有 IDENTITY，插入记录时用我自定义的方式生成主键的值。这个需要的本质就是：我不要数据库给我生成递增ID，我要在程序里生成。

前面老周提过，默认行为下主键列如果是整数类型或 GUID，就会产生自增长的列。所以，咱们有一个很关键的步骤——就是怎么禁止 EF 去产生 IDENTITY 列。如果你看到 EF Core SQL Server 的源代码，可能你会知道有个约定类叫 SqlServerValueGenerationStrategyConvention。这个约定类默认会设置主键列的自动生成策略为 IdentityColumn。

 public virtual void ProcessModelInitialized(
     IConventionModelBuilder modelBuilder,
     IConventionContext<IConventionModelBuilder> context)
     => modelBuilder.HasValueGenerationStrategy(SqlServerValueGenerationStrategy.IdentityColumn);

于是，有大伙伴可能会想到，那我从 SqlServerValueGenerationStrategyConvention 派生出一个类，重写 ProcessModelInitialized 方法，把自动生成策略改为 None，然后在约定集合中替换掉 SqlServerValueGenerationStrategyConvention。

这个思路不是不行，就是工作量大一些。你不仅要定义个新类，还要把它注册到服务容器中替换 SqlServerValueGenerationStrategyConvention 。毕竟 EF Core 框架内部也是使用了服务容器和依赖注入的方式来组织各种组件的。具体做法是在初始化 DbContext 类（包括你派生的类）时会传递一个 DbContextOptions<TContext> 对象，它有一个 ReplaceService 方法，可以替换容器中的服务。在调用 AddSqlServer 方法时就可以配置。

 public static IServiceCollection AddSqlServer<TContext>(
     this IServiceCollection serviceCollection,
     string? connectionString,
     Action<SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = null,
     Action<DbContextOptionsBuilder>? optionsAction = null)
     where TContext : DbContext

上述方案太麻烦，故老周未采用。其实，就算服务初始化时设置了生成策略是 Identity，可我们可以在构建模型时修改它呀。做法就是重写 DbContext 类的 OnModelCreating 方法，然后通过 IConventionModelBuilder.HasValueGenerationStrategy 方法就能修改生成策略。当然，这里头是有点波折的，我们不能在 ModelBuilder 实例上调用，因为这货并不是直接实现 IConventionModelBuilder 接口的，它是这么搞的：

public class ModelBuilder : IInfrastructure<IConventionModelBuilder>

IInfrastructure<T> 接口的作用是把 T 隐藏，不希望程序代码访问类型T。DbContext 类也实现这个接口，但它隐藏的是 IServiceProvider 对象，不想让咱们访问里面注册的服务。也就是说，IConventionModelBuilder 的实现者被隐藏了。不过，EF Core 并没有把事情做得太绝，好歹给了一个扩展方法 GetInfrastructure。用这个扩展方法我们能得到 IConventionModelBuilder 类型的引用。

弄清楚这个原理，代码就好写了。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    IConventionModelBuilder cvbd = modelBuilder.GetInfrastructure();
    if (cvbd.CanSetValueGenerationStrategy(Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.None))
    {
        cvbd.HasValueGenerationStrategy(Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.None);
    }

    ……
}

把生成策略改为 None 后，生成主键列时就不会有 IDENTITY 了。

如果你乐意，可以在插入记录时手动给主键列赋值也行的。不过，为了能自动生成值，我们应该写一个自己的生成类。

public class MyValueGenerator : ValueGenerator<int>
{
    // 返回false表示这个生成的值不是临时，它最终要存入数据库的
    public override bool GeneratesTemporaryValues => false;

    private static readonly Random rand = new((int)DateTime.Now.Ticks);

    public override int Next(EntityEntry entry)
    {
        // 获取所有实体
        DbSet<InputMethod> ents = entry.Context.Set<InputMethod>();
        int newID = default;
        do
        {
            // 生成随机ID
            newID = rand.Next();
        }
        // 保证不重复
        while (ents.Any(x => x.RecoId == newID));
        // 返回新值
        return newID;
    }
}

我这里的逻辑是这样的，值是随机生成的，但要用一个循环去检查这个值是不是已存在数据库中，如果存在，继续生成，直到数值不重复。

实现自定义生成器，有两个抽象类可供选择：

1、如果你生成的值，类型不确定（可能是int，可能是 long，可能是……），那就实现 ValueGenerator 类；

2、如果要生成的值是明确类型的，比如这里是 int，那就实现带泛型参数的 ValueGenerator<TValue> 类。

这两个类有继承关系，ValueGenerator<TValue> 派生自 ValueGenerator 类。需要实现的抽象成员：

A、GeneratesTemporaryValues 属性：只读，返回 bool 值。如果你生成的值是临时的，返回 true，不是临时的，返回 false。啥意思呢。临时的值表示暂时赋值给属性/字段，但 INSERT、UPDATE 时，这个值不会存入数据库；如果不是临时的值，最终会存进数据库。上面例子中，老周让它返回 false，就说明生成的这个值，要写入数据库的。

B、如果继承 ValueGenerator 类，请实现 NextValue 抽象方法，返回类型是 object，就是生成的值；如果继承的是 ValueGenerator<TValue>，请实现 Next 方法，此方法返回的类型由泛型参数决定。上面例子中是 int。

写好生成类后，要把它应用到实体模型中，同样是重写 DbContext 类的 OnModelCreating 方法。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    IConventionModelBuilder cvbd = modelBuilder.GetInfrastructure();
    if (cvbd.CanSetValueGenerationStrategy(Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.None))
    {
        cvbd.HasValueGenerationStrategy(Microsoft.EntityFrameworkCore.Metadata.SqlServerValueGenerationStrategy.None);
    }

    modelBuilder.Entity<InputMethod>().HasKey(e => e.RecoId);
    modelBuilder.Entity<InputMethod>()
        .Property(k => k.RecoId)
        .HasValueGenerator<MyValueGenerator>()
        .ValueGeneratedOnAdd();
    modelBuilder.Entity<InputMethod>().ToTable("tb_ims")
        .Property(x => x.MethodDisplay)
        .IsRequired()
        .HasMaxLength(12);
}

ValueGeneratedOnAdd 方法表示在记录插入数据库时自动生成值，HasValueGenerator 方法设置你自定义的生成器。

现在，有了自定义生成规则，在插入数据时，主键不能赋值。一旦赋值，生成器就无效了。

// 尝试插入两条记录
InputMethod[] ents = [
        new(){ MethodDisplay = "双拼输入", Description="按两个键完成一个音节",Culture="zh-CN"},
        new() { MethodDisplay = "六指输入", Description="专供六个指头的人使用",Culture="zh-CN"}
    ];
dbc.Set<InputMethod>().AddRange(ents);
int result = dbc.SaveChanges();

运行应用程序，你会发现，这次生成的 CREATE TABLE 语句中，RecoId 列已经没有 IDENTITY 关键字了。

info: 2024/8/4 18:41:24.956 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (12ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      SELECT 1
info: 2024/8/4 18:41:24.982 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (4ms) [Parameters=[], CommandType='Text', CommandTimeout='60']
      IF SERVERPROPERTY('EngineEdition') <> 5
      BEGIN
          ALTER DATABASE [CrazyDB] SET SINGLE_USER WITH ROLLBACK IMMEDIATE;
      END;
info: 2024/8/4 18:41:25.003 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (21ms) [Parameters=[], CommandType='Text', CommandTimeout='60']
      DROP DATABASE [CrazyDB];
info: 2024/8/4 18:41:25.104 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (82ms) [Parameters=[], CommandType='Text', CommandTimeout='60']
      CREATE DATABASE [CrazyDB];
info: 2024/8/4 18:41:25.137 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (32ms) [Parameters=[], CommandType='Text', CommandTimeout='60']
      IF SERVERPROPERTY('EngineEdition') <> 5
      BEGIN
          ALTER DATABASE [CrazyDB] SET READ_COMMITTED_SNAPSHOT ON;
      END;
info: 2024/8/4 18:41:25.142 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      SELECT 1
info: 2024/8/4 18:41:25.194 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (6ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      CREATE TABLE [tb_ims] (
          [RecoId] int NOT NULL,
          [MethodDisplay] nvarchar(12) NOT NULL,
          [Description] nvarchar(max) NULL,
          [Culture] nvarchar(max) NULL,
          CONSTRAINT [PK_tb_ims] PRIMARY KEY ([RecoId])
      );
info: 2024/8/4 18:41:25.408 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (24ms) [Parameters=[@__newID_0='?' (DbType = Int32)], CommandType='Text', CommandTimeout='30']
      SELECT CASE
          WHEN EXISTS (
              SELECT 1
              FROM [tb_ims] AS [t]
              WHERE [t].[RecoId] = @__newID_0) THEN CAST(1 AS bit)
          ELSE CAST(0 AS bit)
      END
info: 2024/8/4 18:41:25.448 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (1ms) [Parameters=[@__newID_0='?' (DbType = Int32)], CommandType='Text', CommandTimeout='30']
      SELECT CASE
          WHEN EXISTS (
              SELECT 1
              FROM [tb_ims] AS [t]
              WHERE [t].[RecoId] = @__newID_0) THEN CAST(1 AS bit)
          ELSE CAST(0 AS bit)
      END
info: 2024/8/4 18:41:25.488 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (2ms) [Parameters=[@p0='?' (DbType = Int32), @p1='?' (Size = 4000), @p2='?' (Size = 4000), @p3='?' (Size = 12), @p4='?' (DbType = Int32), @p5='?' (Size = 4000), @p6='?' (Size = 4000), @p7='?' (Size = 12)], CommandType='Text', CommandTimeout='30']
      SET IMPLICIT_TRANSACTIONS OFF;
      SET NOCOUNT ON;
      INSERT INTO [tb_ims] ([RecoId], [Culture], [Description], [MethodDisplay])
      VALUES (@p0, @p1, @p2, @p3),
      (@p4, @p5, @p6, @p7);
更新记录数：2
info: 2024/8/4 18:41:25.524 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
      Executed DbCommand (1ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
      SELECT [t].[RecoId], [t].[Culture], [t].[Description], [t].[MethodDisplay]
      FROM [tb_ims] AS [t]
ID=427211935, Display=六指输入, Culture=zh-CN
ID=1993200136, Display=双拼输入, Culture=zh-CN

怎么样，这玩法是不是很高端？当然，如果主键是字符串类型，你也可以生成字符串的值，一切看你需求，反正原理是相同的。

最后，咱们顺便聊聊如何自动更改日期时间的问题。这个在实际开发中也很常用，比如一个计划表，其实体如下：

public class Plan
{
    /// <summary>
    /// 计划ID
    /// </summary>
    public int ID { get; set; }
    /// <summary>
    /// 计划简述
    /// </summary>
    public string? PlanDesc { get; set; }
    /// <summary>
    /// 计划级别
    /// </summary>
    public int Level { get; set; }
    /// <summary>
    /// 计划创建时间
    /// </summary>
    public DateTime? CreateTime { get; set; }
    /// <summary>
    /// 总计划量
    /// </summary>
    public float TotalTask { get; set; }
    /// <summary>
    /// 完成量
    /// </summary>
    public float Completed { get; set; }
    /// <summary>
    /// 更新时间
    /// </summary>
    public DateTime? UpdateTime { get; set; }
}

最后一个字段 UpdateTime 表示在插入后更新的时间，所以在插入时这个字段可以留 NULL。比如我修改计划完成数 Completed，在写入数据库时自动给 UpdateTime 字段赋当前时间。这个不能用值生成器来做，因为生成器只能在数据插入前或插入后产生一次值，后面更新数据时不会再生成新值，就做不到自动设置更新时间了。所以，这里咱们可以换个思路：重写 DbContext 类的 SaveChanges 方法，在命令发送到数据库之前找出哪些记录被修改过，然后设置 UpdateTime 属性，最后才发送 SQL 语句。这样也能达到自动记录更新时间的功能。

public class MyDBContext : DbContext
{
    ……

    public override int SaveChanges(bool acceptAllChangesOnSuccess)
    {
        var modifieds = from c in ChangeTracker.Entries()
                        where c.State == EntityState.Modified
                              && c.Entity is Plan
                        select c;
        foreach(var obj in modifieds)
        {
            obj.Property(nameof(Plan.UpdateTime)).CurrentValue = DateTime.Now;
        }
        return base.SaveChanges(acceptAllChangesOnSuccess);
    }
}

Modified 表示实体被更改过的状态。修改属性值时，应赋值给 CurrentValue，它代表的是实体当前的值，不要改 OriginalValue 的值，它指的是从数据库中读到的值，多数情况下不用去改，除非你要把当前 DbContext 实例的数据复制到另一个 DbContext 实例。

这样当 Plan 对象被修改后，在提交前会自动设置更新时间。下面是测试代码：

 // 创建上下文
 using var ctx  = new MyDBContext();
 // 测试用，确定删除数据库
 ctx.Database.EnsureDeleted();
 // 确定创建数据库
 ctx.Database.EnsureCreated();

 // 创建三条记录
 Plan p01 = new()
 {
     PlanDesc = "装配电池",
     CreateTime = DateTime.Now,
     TotalTask = 100f,
     Completed = 0f,
 };
 Plan p02 = new Plan()
 {
     PlanDesc = "更换底板",
     CreateTime = DateTime.Now,
     Level = 4,
     TotalTask = 12.0f,
     Completed = 0f
 };
 Plan p03 = new()
 {
     PlanDesc = "清洗盖板",
     TotalTask = 20.5f,
     Completed = 0f,
     CreateTime = DateTime.Now
 };
 ctx.Plans.Add(p01);
 ctx.Plans.Add(p02);
 ctx.Plans.Add(p03);
 // 更新到数据库
 int n = ctx.SaveChanges();
 Console.WriteLine($"已插入{n}条记录");

 // 打印数据
 Print(ctx.Plans);
 MODIFY:     // 这是个标签
 Console.Write("请输入要更新的记录ID：");
 string? line = Console.ReadLine();
 if(line == null)
 {
     Console.WriteLine("你输入了吗？");
     goto MODIFY;    // 回到标签处
 }
 if(!int.TryParse(line, out int id))
 {
     Console.WriteLine("你丫的输入的是整数吗？");
     goto MODIFY;    // 回到标签处
 }
 UPDATE:     // 标签
 Console.Write("请输入计划完成数：");
 line = Console.ReadLine();
 if (line == null)
 {
     Console.WriteLine("你确定你没敲错键盘？");
     goto UPDATE;
 }
 if(!float.TryParse(line, out float comp))
 {
     Console.WriteLine("浮点数，浮点数，浮点数");
     goto UPDATE;
 }
 // 查找
 Plan? curPlan = ctx.Plans.FirstOrDefault(x => x.ID == id);
 if (curPlan == null)
 {
     Console.WriteLine("找不到记录");
     goto MODIFY;
 }
 if(comp > curPlan.TotalTask)
 {
     Console.WriteLine("你是在异空间工作吗？");
     goto UPDATE;
 }
 // 更新
 curPlan.Completed = comp;
 ctx.SaveChanges();

 // 再次打印
 Print(ctx.Plans);

先插入三条数据，然后输入记录ID来修改 Completed 的值。更改后会看到更新时间。

好了，今天咱们就水到这里了。