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 obtener más información sobre la creación y configuración de una instancia de Azure Managed Redis (versión preliminar), 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.

Atributo	Tipo	Valor predeterminado	Descripción
_host*	string	"localhost"	Nombre de host o dirección del IP del servidor de Redis
port	entero positivo	6379 (non-TLS/SSL) 6380 (TLS/SSL) 10 000 para Redis Enterprise y Azure Managed Redis (versión preliminar)	Puerto del servidor de Redis
accessKey	string	""	Contraseña del servidor de Redis con la autorización de Redis habilitada. El valor es una cadena vacía por defecto, lo que significa que el proveedor de estado de sesión no utiliza ninguna contraseña cuando se conecta al servidor Redis. Si el servidor de Redis está en una red de acceso público como Azure Cache for Redis, asegúrese de habilitar la autorización de Redis mejorar la seguridad y proporcione una contraseña segura.
ssl	boolean	false	Si desea conectarse al servidor de Redis a través de TLS. Este valor es false de forma predeterminada, dado que Redis no admite TLS de forma predeterminada. Si usa Azure Cache for Redis, que admite SSL de forma predeterminada, no olvide establecer este valor en true para mejorar la seguridad. El puerto no TLS está deshabilitado de forma predeterminada para las memorias caché nuevas. Especifique true en este valor para usar el puerto que no es TLS. Para más información sobre cómo habilitar el puerto no TLS, vea la sección Puertos de acceso del tema sobre la configuración de una caché.
databaseIdNumber	entero positivo	0	Este atributo se puede especificar únicamente mediante web.config o AppSettings. Especifique qué base de datos de Redis usar.
connectionTimeoutInMilliseconds	entero positivo	Suministrado por StackExchange.Redis	Se usa para establecer ConnectTimeout al crear StackExchange.Redis.ConnectionMultiplexer.
operationTimeoutInMilliseconds	entero positivo	Suministrado por StackExchange.Redis	Se usa para establecer SyncTimeout al crear StackExchange.Redis.ConnectionMultiplexer.
connectionString (cadena de conexión StackExchange.Redis válida)	string	n/a	Una referencia de parámetro a AppSettings o web.config, o una cadena de conexión de StackExchange.Redis válida. Este atributo puede proporcionar valores para host, port, accessKey, ssl y otros atributos de StackExchange.Redis. Para más detalles de connectionString, consulte Valor de connectionString en la sección Notas sobre los atributos.
settingsClassName settingsMethodName	string string	n/a	Estos atributos se pueden especificar únicamente mediante web.config o AppSettings. Use estos atributos para proporcionar una cadena de conexión. _settingsClassName* debe ser un nombre de clase cualificado por el ensamblador que contenga el método especificado por settingsMethodName. El método especificado por settingsMethodName debe ser público, estático y nulo (no acepta ningún parámetro), con un tipo de valor devuelto de cadena. Este método devuelve la cadena de conexión real.
loggingClassName loggingMethodName	string string	n/a	Estos atributos se pueden especificar únicamente mediante web.config o AppSettings. Use estos atributos para depurar la aplicación proporcionando los registros desde la caché de estado de sesión y salida, junto con los registros de StackExchange.Redis. loggingClassName debe ser un nombre de clase completo del ensamblado que contenga el método especificado por loggingMethodName. El método especificado por loggingMethodName debe ser público, estático y nulo (no acepta ningún parámetro), con un tipo de valor devuelto de System.IO.TextWriter.
applicationName	string	El nombre del módulo del proceso actual o "/"	SessionStateProvider only Este atributo se puede especificar únicamente mediante web.config o AppSettings. El prefijo del nombre de aplicación que usar en la memoria caché de Redis. El cliente podría usar la misma caché de Redis para distintos fines. Para garantizar que las claves de sesión no entren en conflicto, se puede prefijar con el nombre de la aplicación.
throwOnError	boolean	true	SessionStateProvider only Este atributo se puede especificar únicamente mediante web.config o AppSettings. Si se produce una excepción cuando se produce un error. Para más información acerca de throwOnError, consulte Notas sobre throwOnError en la sección Notas sobre los atributos.
retryTimeoutInMilliseconds	entero positivo	5000	SessionStateProvider only Este atributo se puede especificar únicamente mediante web.config o AppSettings. Tiempo para volver a intentarlo cuando falla una operación. Si este valor es menor que el de operationTimeoutInMilliseconds, el proveedor no volverá a intentarlo. Para más información acerca de retryTimeoutInMilliseconds, consulte Notas sobre retryTimeoutInMilliseconds en la sección Notas sobre los atributos.
redisSerializerType	string	n/a	Especifica el nombre de tipo calificado de ensamblado de una clase que implementa Microsoft.Web.Redis. Serializador que contiene la lógica personalizada para serializar y deserializar los valores. Para más información, consulte Acerca de redisSerializerType en la sección Notas sobre los atributos.

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.