Get started with the Redis Output Caching integration

The Redis® output caching integration is used to register an ASP.NET Core Output Caching provider backed by a Redis server with the docker.io/library/redis container image.

In this introduction, you’ll see how to install and use the Aspire Redis Output Caching integrations in a simple configuration. If you already have this knowledge, see Redis Output Caching hosting integration for full reference details.

Hinweis

To follow this guide, you must have created an Aspire solution to work with. To learn how to do that, see Build your first Aspire app.

Set up hosting integration

To begin, install the Aspire Redis hosting integration in your Aspire AppHost project:

Aspire CLI

Aspire CLI — Aspire.Hosting.Redis Paket hinzufügen

aspire add redis

Die Aspire CLI ist interaktiv; das passende Suchergebnis wählen, wenn gefragt:

Aspire CLI — Beispielausgabe

Select an integration to add:

> redis (Aspire.Hosting.Redis)
> Other results listed as selectable options...

Hinweis

Gibt es nur ein Ergebnis, wird es automatisch gewählt. Die Version muss trotzdem bestätigt werden.

apphost.cs (C# file-based app)

C# — AppHost.cs

#:package Aspire.Hosting.Redis@*

PackageReference (*.csproj)

XML — Aspire.Hosting.Redis Paketreferenz hinzufügen

<PackageReference Include="Aspire.Hosting.Redis" Version="*" />

Next, in the AppHost project, create instances of Redis resources and pass them to the consuming client projects:

C# — AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache");

var myService = builder.AddProject<Projects.ExampleProject>()
                       .WithReference(cache);

builder.Build().Run();

When Aspire adds a container image to the AppHost, it creates a new Redis instance on your local machine.

Tipp

If you’d rather connect to an existing Redis instance, call AsExisting instead.

Set up client integration

To get started with the Redis output caching integration, install the package:

.NET CLI

.NET CLI — Add Aspire.StackExchange.Redis.OutputCaching package

dotnet add package Aspire.StackExchange.Redis.OutputCaching

Program.cs (C# file-based app)

Program.cs

#:package Aspire.StackExchange.Redis.OutputCaching@*

PackageReference (*.csproj)

XML — Add Aspire.StackExchange.Redis.OutputCaching package reference

<PackageReference Include="Aspire.StackExchange.Redis.OutputCaching" Version="*" />

In the Program.cs file of your client-consuming project, call the AddRedisOutputCache extension method to register the required services for output caching:

builder.AddRedisOutputCache(connectionName: "cache");

Tipp

The connectionName parameter must match the name used when adding the Redis resource in the AppHost project.

Add the middleware to the request processing pipeline by calling UseOutputCache:

var app = builder.Build();

app.UseOutputCache();

For minimal API apps, configure an endpoint to do caching by calling CacheOutput, or by applying the OutputCacheAttribute:

app.MapGet("/cached", () => "Hello world!")
   .CacheOutput();

app.MapGet(
    "/attribute",
    [OutputCache] () => "Hello world!");

For apps with controllers, apply the [OutputCache] attribute to the action method. For Razor Pages apps, apply the attribute to the Razor page class.

See also

• Redis Output Caching hosting integration
• Redis Output Caching client integration
• Main Redis integration

Registered trademark

Redis is a registered trademark of Redis Ltd. Any rights therein are reserved to Redis Ltd. Any use by Microsoft is for referential purposes only and does not indicate any sponsorship, endorsement or affiliation between Redis and Microsoft. :::