FlexQuery.NET 2.3.1

There is a newer version of this package available.
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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FlexQuery.NET" Version="2.3.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FlexQuery.NET" Version="2.3.1" />
                    
Directory.Packages.props
<PackageReference Include="FlexQuery.NET" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add FlexQuery.NET --version 2.3.1
                    
#r "nuget: FlexQuery.NET, 2.3.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package FlexQuery.NET@2.3.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=FlexQuery.NET&version=2.3.1
                    
Install as a Cake Addin
#tool nuget:?package=FlexQuery.NET&version=2.3.1
                    
Install as a Cake Tool

<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.

NuGet Version NuGet Downloads Dotnet Support Documentation License


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 SELECT optimization 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


๐Ÿ“„ License

FlexQuery.NET is licensed under the MIT License.

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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