如何在Entity Framework Core中获取时态表的ValidFrom和ValidTo列

默认调用无参数的IsTemporal()方法时，EF Core会将SQL Server时态表自动生成的周期列ValidFrom、ValidTo配置为阴影属性，不会映射到实体类的公开属性，因此直接通过实体实例访问这两个属性会抛出不存在的错误。

公开映射时态列的配置方法 #

要直接在实体上访问这两个列，只需要完成两步配置：

• 第一步：在对应实体类中定义与列类型匹配的属性，时态表周期列对应C#类型为DateTime，建议统一使用UTC时间格式避免时区偏差

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 定义时态列映射属性
    public DateTime ValidFrom { get; set; }
    public DateTime ValidTo { get; set; }
}

• 第二步：在OnModelCreating配置时态表时，显式指定周期属性和数据库列的映射关系，覆盖默认的阴影属性配置

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Product>().ToTable("Orders", options => 
    {
        options.IsTemporal(temporalConfig =>
        {
            // 显式映射周期列，配置后EF Core会直接将列值填充到实体属性
            temporalConfig.HasPeriodStart(nameof(Product.ValidFrom))
                          .HasColumnName(nameof(Product.ValidFrom));
            temporalConfig.HasPeriodEnd(nameof(Product.ValidTo))
                          .HasColumnName(nameof(Product.ValidTo));
        });
    });
}

配置完成后，无论是普通查询还是TemporalAll()、TemporalAsOf()等时态查询返回的实体实例，都可以直接访问ValidFrom、ValidTo属性，数据库端的时态表自动维护逻辑不会受任何影响。

公共接口统一映射方案的可行性 #

这个方案完全合理，是生产环境中常用的最佳实践，具体实现和优势如下：

1. 首先定义统一的时态实体接口，约定周期属性签名

public interface ITemporalEntity
{
    DateTime ValidFrom { get; set; }
    DateTime ValidTo { get; set; }
}

2. 所有需要映射时态表的实体统一实现该接口，保证属性命名、类型完全一致

public class Product : ITemporalEntity
{
    public int Id { get; set; }
    public string Name { get; set; }
    public DateTime ValidFrom { get; set; }
    public DateTime ValidTo { get; set; }
}

3. 可以在OnModelCreating中批量完成所有时态实体的配置，无需为每个实体重复编写映射代码

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 扫描所有实现ITemporalEntity的实体，批量配置时态表映射
    foreach (var entityType in modelBuilder.Model.GetEntityTypes()
                 .Where(e => typeof(ITemporalEntity).IsAssignableFrom(e.ClrType)))
    {
        entityType.SetIsTemporal(true);
        entityType.FindPeriodStartProperty()?.SetColumnName("ValidFrom");
        entityType.FindPeriodEndProperty()?.SetColumnName("ValidTo");
    }

    // 其余实体配置逻辑
}

该方案的核心优势：

• 统一所有时态实体的属性和列名规范，避免不同实体出现命名不一致的问题
• 支持编写通用的时态查询仓储逻辑，比如实现按时间点查询任意实体历史版本的通用方法，减少重复代码
• 编译期即可检查属性是否存在，避免硬写字段名导致的运行时错误

注意：ValidFrom和ValidTo列的值由数据库引擎自动维护，业务代码中不需要手动给这两个属性赋值，EF Core在新增、更新数据时会自动忽略这两个属性的手动赋值，不会覆盖数据库生成的原生值。

内容的提问来源于stack exchange，提问作者Monset