Proveedor de caché de resultados de ASP.NET para Azure Cache for Redis

El proveedor de la caché de salida de Redis es un mecanismo de almacenamiento fuera de proceso para los datos de la caché de salida. Estos datos resultan necesarios específicamente para respuestas HTTP completas (caché de resultados de la página). El proveedor se conecta al nuevo punto de extensibilidad del proveedor de caché de salida que se introdujo en ASP.NET 4.

Para obtener aplicaciones de ASP.NET Core, vea Almacenamiento en caché de salida en ASP.NET core mediante Redis en .NET 8.

Para usar el proveedor de la caché de salida de Redis, configure primero la caché y luego configure la aplicación de ASP.NET mediante el paquete NuGet del proveedor de la caché de salida de Redis. En este tema se proporcionan instrucciones sobre cómo configurar la aplicación para usar el proveedor de la caché de salida de Redis. Para más información acerca de cómo crear y configurar una instancia de Azure Cache for Redis, consulte Creación de una caché.

Almacenar la salida de la página ASP.NET core en Redis

Para obtener una especificación completa de las características, vea Almacenamiento en caché de salida de ASP.NET Core.

Para ver una aplicación de ejemplo que muestra el uso, consulte Aplicación web de .NET 8 con almacenamiento en caché de salida de Redis y Azure OpenAI.

Almacenar ASP.NET salida de página en Redis

Para configurar una aplicación cliente en Visual Studio usando el paquete NuGet de estado de sesión de Azure Cache for Redis, en el menú Herramientas, seleccione Administrador de paquetes NuGet y Consola del Administrador de paquetes.

Ejecute el siguiente comando desde la ventana Package Manager Console:

Install-Package Microsoft.Web.RedisOutputCacheProvider

El paquete NuGet del proveedor de la caché de salida de Redis tiene una dependencia del paquete StackExchange.Redis. Si el paquete StackExchange.Redis no existe en el proyecto, se instalará. Para obtener más información sobre el paquete de NuGet del proveedor de caché de salida de Redis, vea la página RedisOutputCacheProvider de NuGet.

El paquete NuGet descarga y agrega las referencias de ensamblado necesarias y agrega la siguiente sección al archivo web.config. Esta sección contiene la configuración necesaria para que la aplicación ASP.NET use el proveedor de memoria caché de salida de Redis.

<caching>
  <outputCache defaultProvider="MyRedisOutputCache">
    <providers>
      <add name="MyRedisOutputCache" type="Microsoft.Web.Redis.RedisOutputCacheProvider"
           host=""
           accessKey=""
           ssl="true" />
    </providers>
  </outputCache>
</caching>

Configure los atributos de la primera columna con los valores de la memoria caché en Microsoft Azure Portal. Asimismo, configure los demás valores que desee. Para obtener instrucciones acerca de cómo acceder a las propiedades de la caché, consulte Configuración de Azure Cache for Redis.

Notas sobre los atributos

Valor de connectionString

El valor de connectionString se utiliza como clave para capturar la cadena de conexión real de AppSettings (si este tipo de cadena existe en AppSettings). Si no se encuentra en AppSettings, el valor de connectionString se utilizará como clave para recuperar la cadena de conexión real desde la sección ConnectionString de web.config (si existe esa sección). Si la cadena de conexión no existe en AppSettings o la sección ConnectionString de web.config, se usará el valor literal de connectionString como cadena de conexión al crear StackExchange.Redis.ConnectionMultiplexer.

Los siguientes ejemplos muestran cómo se utiliza connectionString.

Ejemplo 1

<connectionStrings>
    <add name="MyRedisConnectionString" connectionString="mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False" />
</connectionStrings>

En web.config, utilice la clave anterior como valor del parámetro en lugar del valor real.

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             connectionString = "MyRedisConnectionString"/>
    </providers>
</sessionState>

Ejemplo 2

<appSettings>
    <add key="MyRedisConnectionString" value="mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False" />
</appSettings>

En web.config, utilice la clave anterior como valor del parámetro en lugar del valor real.

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             connectionString = "MyRedisConnectionString"/>
    </providers>
</sessionState>

Ejemplo 3

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             connectionString = "mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False"/>
    </providers>
</sessionState>

Notas sobre throwOnError

Actualmente, si se produce un error durante una operación de sesión, el proveedor de estado de sesión produce una excepción. Al iniciar la excepción se cierra la aplicación.

Este comportamiento se modificó para ajustarse a las expectativas de los usuarios existentes del proveedor de estado de sesión de ASP.NET, al tiempo que permite actuar sobre las excepciones. El comportamiento predeterminado todavía produce una excepción cuando se produce un error, de manera coherente con otros proveedores de estado de sesión de ASP.NET. El código existente debería funcionar igual que antes.

Si establece throwOnError en false, en lugar de producir una excepción cuando se produce un error, el error se produce en modo silencioso. Para ver si se produjo un error y, si es así, detectar la excepción, compruebe la propiedad estática Microsoft.Web.Redis.RedisSessionStateProvider.LastException.

Notas sobre retryTimeoutInMilliseconds

La opción retryTimeoutInMilliseconds proporciona cierta lógica para simplificar el caso en el que una operación de sesión debe reintentar en caso de error debido a un problema de red u otro incidente. La opción retryTimeoutInMilliseconds también permite controlar el tiempo de espera del reintento o rechazar completamente el reintento.

Si establece retryTimeoutInMilliseconds en un número, por ejemplo, 2000, cuando se produce un error en una operación de sesión, se vuelve a intentar durante 2,000 milisegundos antes de tratarse como error. Para que el proveedor de estado de sesión aplique esta lógica de reintento, solo tiene que configurar el tiempo de espera. Cuando se produzca un problema de red, el primer reintento se realizará a los 20 milisegundos, tiempo suficiente en la mayoría de los casos. Después de eso, volverá a intentarlo cada segundo hasta que se agote el tiempo de espera. Justo después del tiempo de espera, volverá a intentarlo para asegurarse de que no se corta el tiempo de espera en un segundo (como máximo).

Si cree que no necesita un reintento o si desea controlar la lógica de reintento personalmente, establezca retryTimeoutInMilliseconds en 0. Por ejemplo, es posible que no quiera volver a intentarlo cuando ejecute el servidor de Redis en la misma máquina que la aplicación.

Acerca de redisSerializerType

De forma predeterminada, la serialización para almacenar los valores en Redis se realiza en un formato binario proporcionado por la clase BinaryFormatter. Use redisSerializerType para especificar el nombre del tipo calificado de ensamblado de una clase que implemente Microsoft.Web.Redis.ISerializer y tenga la lógica personalizada para serializar y deserializar los valores. Por ejemplo, esta es una clase de serializador de JSON con JSON.NET:

namespace MyCompany.Redis
{
    public class JsonSerializer : ISerializer
    {
        private static JsonSerializerSettings _settings = new JsonSerializerSettings() { TypeNameHandling = TypeNameHandling.All };

        public byte[] Serialize(object data)
        {
            return Encoding.UTF8.GetBytes(JsonConvert.SerializeObject(data, _settings));
        }

        public object Deserialize(byte[] data)
        {
            if (data == null)
            {
                return null;
            }
            return JsonConvert.DeserializeObject(Encoding.UTF8.GetString(data), _settings);
        }
    }
}

Supongamos que esta clase se define en un ensamblado con nombre MyCompanyDll, puede establecer el parámetro redisSerializerType para usarlo:

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             redisSerializerType = "MyCompany.Redis.JsonSerializer,MyCompanyDll"
             ... />
    </providers>
</sessionState>

Directiva de caché de salida

Incorpore una directiva OutputCache a cada página cuyos resultados desea almacenar en caché.

<%@ OutputCache Duration="60" VaryByParam="*" %>

En el ejemplo anterior, los datos de la página almacenados en la memoria caché permanecerán ahí durante 60 segundos y se almacenará en la memoria caché una versión diferente de la página para cada combinación de parámetros. Para más información sobre la directiva OutputCache, consulte @OutputCache.

Después de realizar estos pasos, la aplicación está configurada para usar el proveedor de la caché de salida de Redis.

Proveedores de caché de resultados de terceros

• NCache
• Apache Ignite

Contenido relacionado

Consulte el proveedor de estado de sesión de ASP.NET para Azure Cache for Redis.