DynamicQuery.NetFramework 2.0.1

DynamicQuery.AspNetCore

OData-inspired URL query binding for ASP.NET Core. Parses query string parameters into LINQ expression trees for filtering, sorting, paging, and projection.

This library is not GraphQL. It binds REST query parameters such as ?query=name=Bruno&order=name&page=0&pagesize=10 to strongly typed expressions you can use with IQueryable, EF Core, or in-memory collections.

Renamed from Graphql.DynamicFilter

This project was originally published as Graphql.DynamicFilter on NuGet (~41k downloads). The old name was misleading — the library provides OData-style URL query binding, not GraphQL.

Starting with 2.0, development continues under new package IDs:

The query string format is unchanged. Only the package name, namespaces, and type names changed (DynamicFilter<T> → DynamicQuery<T>).

Packages

Installation

dotnet add package DynamicQuery.AspNetCore

Quick start — Controllers

using DynamicQuery.AspNetCore;

[HttpGet]
public Task<List<User>> Get(DynamicQuery<User> query)
{
    var result = _users.Apply(query).ToList();
    return Task.FromResult(result);
}

Example request:

GET /api/users?query=name=Bruno

Generated expression:

x => x.Name == "Bruno"

Quick start — Minimal APIs

app.MapGet("/users", (DynamicQuery<User> query) =>
{
    return users.Apply(query).ToList();
});

DynamicQuery<T> implements the minimal API BindAsync convention automatically.

Query syntax

Multiple filters are combined with AND (comma-separated). Use | within a value for OR.

Use query= or filter= for the filter parameter (both are supported).

Ordering

GET /api/users?query=name%b&order=name=Asc
GET /api/users?query=name%b&order=name=Desc

If direction is omitted, default is Desc (same as v1.x ASP.NET Core behavior).

Paging

GET /api/users?query=name%b&order=name&page=0&pagesize=10

Projection (select)

GET /api/users?select=name,age

Populates query.Select (Expression<Func<T,T>>) and query.SelectText.

Apply helper

using DynamicQuery.AspNetCore;

// In-memory collections (uses compiled expressions)
var items = users.Apply(query);

// IQueryable / EF Core (uses expression trees)
var items = dbContext.Users.Apply(query);

MVC registration (optional)

Model binding works via the [ModelBinder] attribute on DynamicQuery<T>. To register the binder provider explicitly:

builder.Services.AddControllers()
    .AddDynamicQuery();

Migration from Graphql.DynamicFilter 1.x

If you installed the old package:

# Remove the legacy package
dotnet remove package Graphql.DynamicFilter

# Install the renamed package
dotnet add package DynamicQuery.AspNetCore

Update your code:

• using Graphql.DynamicFiltering → using DynamicQuery.AspNetCore
• DynamicFilter<T> → DynamicQuery<T>

Full details: CHANGELOG.md

Development

dotnet build DynamicQuery.sln
dotnet test DynamicQuery.sln

License

MIT — see LICENSE.