【EF Core】自动生成的字段值

  • 【EF Core】自动生成的字段值已关闭评论
  • 15 次浏览
  • A+
所属分类:.NET技术
摘要

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

自动生成字段值,咱们首先想到的是主键列(带 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; }

【EF Core】自动生成的字段值

说明人家只认 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 的值。更改后会看到更新时间。

【EF Core】自动生成的字段值

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