C#中如何使用EF Core的查询过滤器?如何动态启用?

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

在C#中使用EF Core的查询过滤器,可以通过全局查询过滤器(Global Query Filters)实现自动为实体添加条件。这种机制常用于软删除、多租户等场景。下面介绍如何定义和动态启用查询过滤器。

定义全局查询过滤器

OnModelCreating 方法中为实体配置过滤器。例如,为实现软删除,假设有一个 IsDeleted 字段:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .HasQueryFilter(b => !b.IsDeleted);
}

这样每次查询 Blog 时,EF Core 自动加上 WHERE IsDeleted = false 的条件。

排除查询过滤器(动态启用/禁用)

全局过滤器默认始终启用,但可通过 IgnoreQueryFilters() 方法临时跳过:

// 查询包含已删除的记录
var blogs = context.Blogs.IgnoreQueryFilters().ToList();

这在需要查看软删除数据或管理功能时非常有用。注意:该方法会完全忽略当前查询中的所有过滤器,需谨慎使用。

基于上下文状态动态控制过滤器

若想更精细地控制,可在 OnModelCreating 中结合上下文属性动态设置过滤器:

public class AppDbContext : DbContext
{
    public bool IgnoreSoftDeleteFilter { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Blog>()
            .HasQueryFilter(b => !b.IsDeleted || !((AppDbContext)modelBuilder.Model.GetService<ICurrentDbContext>().Context).IgnoreSoftDeleteFilter);
    }
}

上面写法稍复杂,更推荐通过依赖注入传递状态。一个简洁做法是使用参数化过滤器:

private readonly bool _includeDeleted;
public AppDbContext(bool includeDeleted = false)
{
    _includeDeleted = includeDeleted;
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .HasQueryFilter(b => _includeDeleted || !b.IsDeleted);
}

创建上下文实例时指定是否包含已删除数据:

using var context = new AppDbContext(includeDeleted: true);
var blogs = context.Blogs.ToList(); // 包含已删除

基本上就这些。合理使用查询过滤器能减少重复代码,动态控制则提升了灵活性。关键是理解 HasQueryFilterIgnoreQueryFilters() 的配合使用。

相关推荐