🚀 如何在 .NET8+ 中轻松使用 WhereDynamic 构建动态 LINQ 查询

Source: Dev.to

Introducing WhereDynamic

我们都有过这样的经历：写无尽的 if 语句来构建条件查询，或者在多个端点之间复制逻辑，只是为了处理不同的过滤组合。这样既混乱又容易出错，且难以维护。

The Problem

在使用 .NET 和 Entity Framework 构建 API 或数据驱动的应用时，通常需要根据用户输入应用过滤条件。传统做法会导致代码臃肿。

The Solution

WhereDynamic 提供了一种简洁、类型安全的方式，在运行时组合 LINQ Where 子句，消除重复的条件逻辑，同时保持 EF Core 完全翻译为 SQL。

Practical Use Cases

1. Advanced Search Filters

构建复杂的搜索页面，用户可以任意组合条件（例如日期范围、文本匹配、数值范围），而无需为每种组合编写单独的查询。

2. Multi‑Tenant Data Filtering

自动应用租户特定的过滤，确保每个请求只能访问属于当前租户的数据。

3. API Query Parameters

将查询字符串参数直接映射为 LINQ 谓词，为 REST 或 GraphQL 端点提供灵活的、由客户端驱动的过滤功能。

4. Complex Nested Conditions

动态组合嵌套的 AND/OR 组，支持诸如 “(A AND B) OR (C AND (D OR E))” 的场景，而无需硬编码逻辑。

Key Benefits

• Cleaner Code – 消除重复的条件逻辑。
• Type Safety – 编译时检查并提供 IntelliSense 支持。
• Performance – 直接翻译为优化的 SQL 查询。
• Maintainability – 集中管理过滤逻辑，便于测试和扩展。
• Flexibility – 与现有的 Entity Framework 代码无缝协作。

Built For Modern .NET

WhereDynamic 基于 .NET 8+ 构建，完全兼容 Entity Framework Core，并以性能和开发者体验为核心设计。无论是构建 REST API、GraphQL 端点，还是复杂的报表系统，它都能适应你的需求。