BonyadCode.Paginator.AspNetCore 1.0.4

BonyadCode.Paginator.AspNetCore

A minimal yet powerful pagination utility for .NET developers. Enables easy paging over IQueryable<T> or IEnumerable<T> sources with optional dynamic ordering via expressions or property names — ideal for APIs, dashboards, and any list-heavy UIs.

✨ Features

• Unified Paging API: Works seamlessly with both IQueryable (e.g., EF Core) and IEnumerable.
• Dynamic Ordering: Sort by expression or string field name (e.g., "CreatedAt").
• Smart Caching: Expression caching ensures optimal performance for repeated queries.
• Async + Sync Support: Optimized methods for both LINQ-to-Objects and LINQ-to-Entities.
• Safe Defaults: Sensible defaults for page size, number, and ordering.

📦 Installation

dotnet add package BonyadCode.Paginator.AspNetCore

🚀 Quick Examples

✅ Paginate an EF Core Query

var request = new PagedRequest
{
    PageNumber = 2,
    PageSize = 10,
    OrderBy = "CreatedAt",
    AscendingOrder = true
};

var result = await dbContext.Users
    .Where(u => u.IsActive)
    .ToPagedResponseAsync(request, cancellationToken: cancellationToken);

or

var request = new PagedRequest
{
    PageNumber = 2,
    PageSize = 10,
    OrderBy = nameof(Request.CreatedAt),
    AscendingOrder = true
};

var result = await dbContext.Users
    .Where(u => u.IsActive)
    .ToPagedResponseAsync(request, cancellationToken: cancellationToken);

Result JSON:

{
  "pageNumber": 2,
  "pageSize": 10,
  "pageCount": 5,
  "itemCount": 42,
  "hasPreviousPage": true,
  "hasNextPage": true,
  "items": [ /* paginated users */ ]
}

✅ Paginate an In-Memory List

var users = new List<User> { /* ... */ };

var request = new PagedRequest
{
    PageNumber = 1,
    PageSize = 5,
    OrderBy = "Username",
    AscendingOrder = false
};

var result = users.ToPagedResponse(request);

📘 API Overview

📟 PagedRequest

📦 PageBuilder<T>

🧐 Advanced Usage

📌 Paginate with Expression

Expression<Func<User, object>> orderByExpr = x => x.Email;

var result = await dbContext.Users
    .ToPagedResponseAsync(request, orderByExpr, cancellationToken);

🔄 Runtime Property Sorting

var result = await dbContext.Products
    .ToPagedResponseAsync(new PagedRequest
    {
        OrderBy = "Price",
        AscendingOrder = true
    });

Field name must match a public property of the type (case-insensitive).

🔧 Internals & Performance

• Uses ConcurrentDictionary<Type, Dictionary<string, Expression>> for dynamic sorting — field expressions are cached per type for reuse.
• Null-safe and validated defaults — throws if PageSize == 0.
• CancellationToken respected on all async methods.
• Compatible with both System.Linq and Microsoft.EntityFrameworkCore.

🤝 Contributing

Contributions, suggestions, and PRs are welcome! GitHub →

📄 License

Apache 2.0 — see the LICENSE file.

📦 Links

• NuGet
• GitHub