Nextended.Cache 10.1.32

Nextended.Cache

Expression-based caching — automatic cache keys from method expressions, CacheProvider with condition-based invalidation, thread-safe AddOrGetExisting.

📖 Documentation: English · Deutsch

Installation

dotnet add package Nextended.Cache

The idea

Most caching code is the same four lines: build a key, look it up, run the expensive thing, store it. The key is where it goes wrong — it is written by hand, it forgets a parameter, and two call sites disagree.

Nextended.Cache derives the key from the call expression instead. You hand it the call you would have made, and the key is built from the declaring type, the result type, the method name and the actual argument values.

Quick start

Cache a method call without naming a key

using Nextended.Cache;

public class UserService
{
    private readonly CacheProvider _cache = new();

    public User GetUser(int userId)
        // The lambda receives the instance, so the expression can be inspected.
        => _cache.ExecuteWithCache(this, self => self.LoadUserFromDb(userId));

    private User LoadUserFromDb(int userId) => /* the expensive call */;
}

The generated key looks like MyApp.UserService_MyApp.User=UserService.LoadUserFromDb(userId=42) — a different userId is a different entry, automatically.

Important The lambda body must be a method call. self => self.Property or a closure with no call (() => Load(id)) cannot be turned into a key and will throw an InvalidCastException.

Straight onto IMemoryCache

using Nextended.Cache.Extensions;

var info = this.ExecuteWithCache(memoryCache, self => self.LoadReport(reportId));

info.Result;      // the value
info.Key;         // the generated key
info.IsNewEntry;  // false when it came from the cache

ExecuteWithCache also accepts an explicit key when you want one, and a MemoryCacheEntryOptions for expiration and priority. cache.MemoryCacheEntryOptions(token) builds a sensible default (normal priority, one-hour absolute expiration, bound to a cancellation token).

Condition-based invalidation

CacheProvider can watch itself and drop everything when a condition turns true. Conditions are evaluated on a background task every ClearCheckInterval (default 10 minutes).

var cache = new CacheProvider();
cache.ClearCheckInterval = TimeSpan.FromMinutes(1);

cache.ClearWhen(c => (DateTime.Now - c.LastWriteTime).TotalHours > 1)
     .ClearWhen(c => c.Count() > 10_000);

cache.Cleared += (_, _) => logger.LogInformation("cache dropped");

Clear() works by cancelling an expiration token that every entry is registered against, so a clear is O(1) rather than an enumeration.

Thread-safe ObjectCache initialisation

For System.Runtime.Caching, AddOrGetExisting wraps the factory in a Lazy<T> so the expensive call runs exactly once even under concurrent access — the classic AddOrGetExisting returns the existing entry after your factory already ran.

using System.Runtime.Caching;
using Nextended.Cache.Extensions;

var rates = MemoryCache.Default.AddOrGetExisting(
    "exchange-rates",
    () => LoadExchangeRates(),
    DateTimeOffset.Now.AddMinutes(10));

Configuration

var cache = new CacheProvider(
    memoryCache,
    new MemoryCacheEntryOptions()
        .SetPriority(CacheItemPriority.High)
        .SetAbsoluteExpiration(TimeSpan.FromMinutes(15)));

Supported frameworks

• net8.0
• net9.0
• net10.0

Dependencies

• Nextended.Core

The Nextended family

The other 17 packages in the suite:

Core libraries

• Nextended.Core — Foundation library — extension methods, custom types (Money, Date, BaseId, SuperType), class mapping, deep clone, encryption, hashing and the code-generation attributes.
• Nextended.Cache — Expression-based caching — automatic cache keys from method expressions, CacheProvider with condition-based invalidation, thread-safe AddOrGetExisting. (this package)

Data access

• Nextended.EF — Entity Framework Core extensions — graph loading (LoadGraphAsync, IncludeAll, MultiInclude), declarative include definitions, paging, dynamic sorting and bulk operations.

ASP.NET Core & web

• Nextended.Web — ASP.NET Core utilities — zero-config OData (AddODataAuto), composable IQueryable OData appliers, strongly typed controller URLs, streaming download helpers and a background executor that can replay a captured request.
• Nextended.ResponseFilters — Fluent, provider-agnostic pipeline that redacts, masks, rounds, truncates, hashes, prunes and restructures response DTOs before serialization — per request, per user, per permission.
• Nextended.ResponseFilters.AspNetCore — ASP.NET Core adapter for Nextended.ResponseFilters — registers the pipeline as a global IAsyncResultFilter and replays structural edits against the serialized JSON tree.

UI libraries

• Nextended.Blazor — Blazor helpers — IBrowserFile extensions (bytes, data URLs, downloads), a hierarchical model for browsing inside uploaded zip/tar/rar archives, MIME-type detection and component-parameter reflection.
• Nextended.UI — WPF and Windows desktop helpers — a global input-binding manager with hold/sequence matching, DirectInput and XInput gamepad readers, key-bind capture controls, converters, behaviours, markup extensions and runtime-defined PropertyGrid types.

Code generation & tooling

• Nextended.Imaging — Image processing — aspect-preserving resize, crop, colour replacement, brightness-based foreground picking, thumbnail generation, byte/data-URL conversion and MIME detection from magic bytes.
• Nextended.CodeGen — Roslyn source generator — DTOs and interfaces from your entities, strongly typed classes from JSON/XML, lookup tables from Excel, and documentation from source files.

.NET Aspire hosting

• Nextended.Aspire — Conditional AppHost builder extensions — WithReferenceIf / WaitForIf / WithExplicitStartIf, strongly typed environment variables from config objects, HTTPS dev-cert wiring, Docker guards, GitHub-source resources and npm app discovery.
• Nextended.Aspire.Hosting.Supabase — The complete Supabase stack — Postgres, Auth (GoTrue), REST, Realtime, Storage, Studio, Kong and Edge Functions — as one composable Aspire resource.
• Nextended.Aspire.Hosting.N8n — The n8n workflow-automation platform as an Aspire resource, with Postgres persistence, workflow import and a typed client for triggering workflows from .NET.
• Nextended.Aspire.Hosting.Grafana — Grafana, Prometheus, Loki, Tempo, Promtail, cAdvisor, postgres_exporter and the OpenTelemetry Collector as composable resources with auto-provisioned datasources.
• Nextended.Aspire.Hosting.WebDataStudio — WebDataStudio — a browser database studio for PostgreSQL, MySQL, SQL Server, SQLite, Oracle, DuckDB, ClickHouse, MongoDB and Redis — wired to the databases of your stack.
• Nextended.Aspire.Hosting.AspireUI — AspireUI — the visual AppHost builder — as a resource inside your own Aspire stack, with an optional pre-seeded admin user and a starter stack built from your project paths.
• Nextended.Aspire.Hosting.LocalAI — Self-hosted, OpenAI-compatible multimodal AI — image generation, text-to-speech, speech-to-text and video — with gallery model management, GPU support and Open WebUI.
• Nextended.Aspire.Hosting.Php — Run PHP endpoints inside your Aspire stack — a docroot folder or a single router script served by PHP's built-in web server, with php.ini settings as fluent options.

Links

• 📦 NuGet package
• 📖 Documentation — English
• 📖 Dokumentation — Deutsch
• 🏠 Documentation portal
• 🧑‍💻 Source code
• 🐛 Report an issue

License

GPL-3.0-or-later — see LICENSE.