阴影属性¶
阴影属性是未在 .NET 实体类中定义但在 EF Core 模型中为该实体类型定义的属性。 这些属性的值和状态纯粹在更改跟踪器中进行维护。 当数据库中的数据不应在映射的实体类型上公开时,阴影属性非常有用。
外键阴影属性¶
阴影属性最常用于外键属性,其中两个实体之间的关系由数据库中的外键值表示,但使用实体之间的导航属性在实体类型上管理关系各种. 按照约定,当发现关系但在依赖实体类中找不到外键属性时,EF 会引入一个阴影属性。
例如,下面的代码列表将导致向 Post 实体引入 BlogId 影子属性:
class MyContext : DbContext
{
public DbSet<Blog> Blogs { get; set; }
public DbSet<Post> Posts { get; set; }
}
public class Blog
{
public int BlogId { get; set; }
public string Url { get; set; }
public List<Post> Posts { get; set; }
}
public class Post
{
public int PostId { get; set; }
public string Title { get; set; }
public string Content { get; set; }
public Blog Blog { get; set; }
}
配置阴影属性¶
你可以使用 "Fluent API" 配置阴影属性。 在您调用了 Property的字符串重载后,您可以将对其他属性的任何配置调用链接在一起。 在下面的示例中,由于 Blog 没有名为 LastUpdated 的 CLR 属性,因此将创建一个阴影属性:
class MyContext : DbContext
{
public DbSet<Blog> Blogs { get; set; }
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Blog>()
.Property<DateTime>("LastUpdated");
}
}
public class Blog
{
public int BlogId { get; set; }
public string Url { get; set; }
}
如果提供给 Property 方法的名称与现有属性(在实体类中定义)的名称相匹配,则代码将配置该现有属性,而不是引入新的阴影属性。
访问阴影属性¶
可以通过 ChangeTracker API 获取和更改影子属性值:
context.Entry(myBlog).Property("LastUpdated").CurrentValue = DateTime.Now;
可以通过 EF.Property 静态方法在 LINQ 查询中引用阴影属性:
var blogs = context.Blogs.OrderBy(b => EF.Property<DateTime>(b, "LastUpdated"));