FlexQuery.NET
2.3.1
See the version list below for details.
dotnet add package FlexQuery.NET --version 2.3.1
NuGet\Install-Package FlexQuery.NET -Version 2.3.1
<PackageReference Include="FlexQuery.NET" Version="2.3.1" />
<PackageVersion Include="FlexQuery.NET" Version="2.3.1" />
<PackageReference Include="FlexQuery.NET" />
paket add FlexQuery.NET --version 2.3.1
#r "nuget: FlexQuery.NET, 2.3.1"
#:package FlexQuery.NET@2.3.1
#addin nuget:?package=FlexQuery.NET&version=2.3.1
#tool nuget:?package=FlexQuery.NET&version=2.3.1
<p align="center"> <img src="https://raw.githubusercontent.com/peterjohncasasola/FlexQuery.NET/main/assets/logo.png" alt="FlexQuery.NET Logo" width="400"> </p>
FlexQuery.NET
Dynamic filtering, sorting, paging, and projection for IQueryable in .NET.
FlexQuery.NET is a lightweight and powerful dynamic query engine for .NET. It allows you to transform complex API query parameters into optimized, EF Core-translatable expression trees with a single line of code.
โก Key Features
- Dynamic Querying: Powerful DSL, JQL, and JSON-based filtering.
- IQueryable-Native: 100% server-side translationโno client-side evaluation.
- Advanced Projection: Automatic SQL
SELECToptimization including nested includes. - Governance & Security: Built-in field-level validation and operator restrictions.
- High Performance: Thread-safe expression caching for ultra-low latency.
- Explicit Joins: SQL-like join support with alias-aware field resolution.
๐ Quick Start
1. Installation
dotnet add package FlexQuery.NET
dotnet add package FlexQuery.NET.EFCore
dotnet add package FlexQuery.NET.AspNetCore
2. Simple Usage
Securely execute a dynamic query directly from your controller:
[HttpGet]
public async Task<IActionResult> GetUsers([FromQuery] FlexQueryParameters parameters)
{
// One-stop shop: Parsing + Validation + Execution
var result = await _context.Users.FlexQueryAsync(parameters, options =>
{
options.AllowedFields = ["Id", "Name", "Email", "Status"];
options.AllowOperators("Status", FilterOperators.Eq, FilterOperators.In);
});
return Ok(result);
}
3. Example Request
GET /api/users?filter=age:gt:18&sort=createdAt:desc&page=1&pageSize=20&select=id,name,email
๐ Documentation
For detailed guides, API references, and advanced scenarios, visit our documentation site:
๐ https://flexquery.vercel.app
Quick Links
- Getting Started
- Query Composition
- Explicit Joins
- Governance & Security
- Performance Optimization
- Migration Guide (v1 โ v2)
๐ License
FlexQuery.NET is licensed under the MIT License.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net6.0
- Microsoft.Extensions.Primitives (>= 6.0.0)
-
net7.0
- Microsoft.Extensions.Primitives (>= 7.0.0)
-
net8.0
- Microsoft.Extensions.Primitives (>= 8.0.0)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on FlexQuery.NET:
| Package | Downloads |
|---|---|
|
FlexQuery.NET.EFCore
EF Core integration for FlexQuery.NET โ async execution, filtered includes, projection, and pagination helpers |
|
|
FlexQuery.NET.AspNetCore
ASP.NET Core integration for FlexQuery.NET โ declarative field-access security via [FieldAccess] attributes and action filters |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.5.0 | 244 | 5/13/2026 |
| 2.4.0 | 145 | 5/10/2026 |
| 2.3.1 | 156 | 5/8/2026 |
| 2.3.0 | 147 | 5/7/2026 |
| 2.2.0 | 149 | 5/6/2026 |
| 2.1.0 | 143 | 5/6/2026 |
| 2.0.1 | 145 | 5/6/2026 |
| 1.7.2 | 149 | 5/4/2026 |
| 1.7.1 | 143 | 5/2/2026 |
| 1.6.2 | 153 | 5/2/2026 |
| 1.5.2 | 93 | 5/2/2026 |
| 1.5.1 | 99 | 5/2/2026 |
| 1.5.0 | 95 | 5/2/2026 |
| 1.4.0 | 98 | 5/2/2026 |
| 1.3.2 | 94 | 5/2/2026 |
| 1.3.1 | 99 | 5/2/2026 |
| 1.3.0 | 89 | 5/2/2026 |
| 1.2.0 | 98 | 5/2/2026 |
| 1.1.1 | 92 | 5/2/2026 |
| 1.1.0 | 100 | 5/2/2026 |
- improved parser added caching
- added benchmark test