C#中如何使用EF Core的查询类型?有什么限制?

来源:这里教程网 时间:2026-02-21 17:26:35 作者:

在 EF Core 中,查询类型(Query Types)是一种用于表示只读数据的模型配置方式,通常用来映射数据库视图、存储过程返回结果或自定义 SQL 查询结果。从 EF Core 6.0 开始,查询类型已被弃用,取而代之的是使用只读实体类型(通过

HasNoKey
配置)来实现相同功能。因此,当前推荐的做法是使用无主键的实体类型来替代传统的查询类型。

如何使用无主键类型替代查询类型

虽然“查询类型”不再作为独立概念存在,但你可以通过以下方式实现类似功能:

定义一个类表示查询结果:这个类不需要主键,可以对应视图、SQL 查询或复杂投影。 在 DbContext 中使用
DbSet
IQueryable
属性
,并通过
HasNoKey()
配置告诉 EF Core 这个类型没有主键。
使用原始 SQL 查询或 FromSqlRaw / FromSqlInterpolated 方法加载数据。 示例代码:
public class OrderSummary
{
    public string CustomerName { get; set; }
    public decimal TotalAmount { get; set; }
    public int OrderCount { get; set; }
}
public class AppDbContext : DbContext
{
    public DbSet<OrderSummary> OrderSummaries { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<OrderSummary>().HasNoKey();
        modelBuilder.Entity<OrderSummary>().ToView("vw_OrderSummary"); // 可选:映射到视图
    }
}

然后你可以像普通 DbSet 一样查询:

var summaries = context.OrderSummaries.ToList();

或者执行自定义 SQL:

var year = 2024;
var summaries = context.OrderSummaries
    .FromSqlInterpolated($@"SELECT c.Name as CustomerName, 
                                   SUM(o.Amount) as TotalAmount,
                                   COUNT(o.Id) as OrderCount
                            FROM Customers c
                            JOIN Orders o ON c.Id = o.CustomerId
                            WHERE YEAR(o.OrderDate) = {year}
                            GROUP BY c.Name")
    .ToList();

限制和注意事项

由于这类类型没有主键且不参与变更跟踪,存在以下限制:

不能插入、更新或删除:EF Core 不会跟踪这些对象的状态变化,因此无法保存更改回数据库。 不能包含导航属性指向其他实体:虽然可以手动编写包含关联的查询,但 EF Core 不支持自动加载相关数据(如 Include)。 不能被其他实体引用作为外键目标:因为没有主键,无法建立关系约束。 ToView 和 ToFunction 映射需手动维护同步:如果数据库视图结构改变,模型也必须相应更新,否则运行时报错。 迁移支持有限:EF Core 不会为
HasNoKey
类型生成创建视图的迁移,需要手动编写 SQL 脚本。

适用场景

这种模式适合以下情况:

展示报表数据(如统计汇总) 封装复杂的只读查询逻辑 对接数据库视图或函数结果 避免将完整实体暴露给前端,仅返回所需字段子集

基本上就这些。尽管“查询类型”已退出历史舞台,但通过

HasNoKey
的方式更统一地处理只读场景,简化了模型设计。只要记住它不可写、不跟踪、不支持导航即可。合理使用能提升查询性能与安全性。

相关推荐