C#中如何使用EF Core的全局查询过滤器？如何配置？-C#.Net教程-PHP中文网

C#中如何使用EF Core的全局查询过滤器？如何配置？

幻夢星雲

发布： 2025-10-12 12:40:02

原创

229人浏览过

全局查询过滤器是在 EF Core 中通过 HasQueryFilter 方法在 OnModelCreating 中配置的 LINQ 条件，可自动应用于实体的所有查询，常用于软删除和多租户场景。

c#中如何使用ef core的全局查询过滤器？如何配置？

在 C# 中使用 EF Core 的全局查询过滤器，可以通过 HasQueryFilter 方法在 OnModelCreating 方法中配置。这个功能常用于实现软删除、多租户等场景，确保每次查询都自动应用特定条件。

什么是全局查询过滤器？

全局查询过滤器是定义在实体上的 LINQ 条件，会自动应用于该实体所有数据库查询（包括 Include 和直接查询）。只要上下文实例存在，这些过滤器就会生效。

如何配置全局查询过滤器？

在继承 DbContext 的类中重写 OnModelCreating 方法，并使用 HasQueryFilter 为实体设置过滤条件。

示例：实现软删除

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }

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

        modelBuilder.Entity<Post>()
            .HasQueryFilter(p => !p.IsDeleted);
    }
}

public class Blog
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsDeleted { get; set; }
}

public class Post
{
    public int Id { get; set; }
    public string Title { get; set; }
    public bool IsDeleted { get; set; }
    public int BlogId { get; set; }
    public Blog Blog { get; set; }
}

登录后复制

配置后，所有对 Blog 和 Post 的查询都会自动加上 !IsDeleted 条件，无需手动添加。

忽略全局过滤器的方法

某些情况下需要绕过过滤器，比如查看已软删除的数据，可以使用 IgnoreQueryFilters() 方法。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

// 获取包含已删除的博客
var deletedBlogs = context.Blogs.IgnoreQueryFilters().Where(b => b.IsDeleted).ToList();

登录后复制

支持复杂条件和关联过滤

查询过滤器支持复杂的表达式，甚至可以引用其他实体或服务（需配合依赖注入）。

示例：多租户支持

private readonly string _tenantId;

public BloggingContext(string tenantId)
{
    _tenantId = tenantId;
}

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

登录后复制

这样每个租户只能访问自己的数据，安全性更高。