无主键实体类型

2025-06-09

注释

此功能是在查询类型的名称下添加的。后来将其重命名为无键实体类型。

除了常规实体类型之外，EF Core 模型还可以包含 无键实体类型，这些类型可用于对不包含键值的数据执行数据库查询。

定义无键实体类型

可按如下所示定义无键实体类型：

数据注释
Fluent API

[Keyless]
public class BlogPostsCount
{
    public string BlogName { get; set; }
    public int PostCount { get; set; }
}

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<BlogPostsCount>()
        .HasNoKey();
}

无键实体类型特征

无键实体类型支持许多与常规实体类型相同的映射功能，例如继承映射和导航属性。在关系存储中，他们可以通过 Fluent API 方法或数据注释来配置目标数据库对象和列。

但是，它们与常规实体类型不同，因为它们：

无法定义密钥。
从不跟踪 DbContext 中的更改，因此永远不会在数据库上插入、更新或删除。
从未通过惯例被发现。
只支持导航映射功能的子集，具体是：
- 他们可能永远不会充当关系的主要目的。
- 它们可能没有指向所属实体的导航功能
- 它们只能包含指向常规实体的引用导航属性。
- 实体不能包含无键实体类型的导航属性。
需要配置[Keyless]数据注释或调用.HasNoKey()方法。
可以将其映射到 定义查询。定义查询是在模型中声明的查询，该查询充当无键实体类型的数据源。
可以具有层次结构，但必须将其映射为TPH。
不能使用表格拆分或实体拆分。

使用场景

无键实体类型的一些主要使用方案包括：

用作 SQL 查询的返回类型。
映射到不包含主键的数据库视图。
映射到未定义主键的数据库表。
映射到模型中定义的查询。

映射到数据库对象

使用 ToTable 或 ToView Fluent API 将无键实体类型映射到数据库对象。从 EF Core 的角度来看，此方法中指定的数据库对象 是视图，这意味着它被视为只读查询源，不能是更新、插入或删除作的目标。但是，这并不意味着数据库对象实际上需要是一个数据库视图。也可以是将被视为只读的数据库表。相反，对于常规实体类型，EF Core 假定方法中指定的 ToTable 数据库对象可以视为表，这意味着它可以用作查询源，也可以由更新、删除和插入作作为目标。事实上，可以指定数据库视图 ToTable 的名称，只要视图配置为可在数据库上更新，所有内容都应正常工作。

示例：

以下示例演示如何使用无键实体类型查询数据库视图。

小窍门

可以在 GitHub 上查看本文的示例。

首先，我们定义一个简单的博客和文章模型：

public class Blog
{
    public int BlogId { get; set; }
    public string Name { get; set; }
    public string Url { get; set; }
    public ICollection<Post> Posts { get; set; }
}

public class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
    public int BlogId { get; set; }
}

接下来，我们定义一个简单的数据库视图，允许我们查询与每个博客关联的文章数：

await db.Database.ExecuteSqlRawAsync(
    @"CREATE VIEW View_BlogPostCounts AS
                SELECT b.Name, Count(p.PostId) as PostCount
                FROM Blogs b
                JOIN Posts p on p.BlogId = b.BlogId
                GROUP BY b.Name");

接下来，我们定义一个类来保存数据库视图中的结果：

public class BlogPostsCount
{
    public string BlogName { get; set; }
    public int PostCount { get; set; }
}

接下来，我们使用 API 在 OnModelCreatingHasNoKey 中配置无键实体类型。我们使用流式配置 API 来配置无键实体类型的映射：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Entity<BlogPostsCount>(
            eb =>
            {
                eb.HasNoKey();
                eb.ToView("View_BlogPostCounts");
                eb.Property(v => v.BlogName).HasColumnName("Name");
            });
}

接下来，我们将配置 DbContext 以包括 DbSet<T>：

public DbSet<BlogPostsCount> BlogPostCounts { get; set; }

最后，我们可以以标准方式查询数据库视图：

var postCounts = await db.BlogPostCounts.ToListAsync();

foreach (var postCount in postCounts)
{
    Console.WriteLine($"{postCount.BlogName} has {postCount.PostCount} posts.");
    Console.WriteLine();
}

小窍门

请注意，我们还定义了上下文级别查询属性（DbSet），以充当针对此类型的查询的根。

小窍门

若要使用内存提供程序测试映射到视图的无键实体类型，请通过 ToInMemoryQuery 将其映射为查询。有关详细信息，请参阅内存中提供程序文档。

通过

无主键实体类型

定义无键实体类型

无键实体类型特征

使用场景

映射到数据库对象

示例：

其他资源