Provider di cache di output ASP.NET per la Cache Redis di Azure

Il provider di cache Redis di output è un meccanismo di memorizzazione out-of-process per i dati della cache di output. Tali dati sono specificamente utilizzati per le risposte HTTP complete (memorizzazione nella cache di output delle pagine). Il provider viene inserito nel nuovo punto di estendibilità del provider di cache di output che è stato introdotto in ASP.NET 4.

Per le applicazioni ASP.NET Core, vedere Memorizzazione nella cache dell'output in ASP.NET core con Redis in .NET 8.

Per usare il provider di cache Redis di output, configurare prima di tutto la cache, quindi configurare l'applicazione ASP.NET usando il pacchetto NuGet del provider di cache Redis di output. Questo argomento offre indicazioni sulla configurazione dell'applicazione per l'uso del provider di cache di output Redis. Per altre informazioni sulla creazione e sulla configurazione di un'istanza della Cache Redis di Azure, vedere Creare una cache.

Archiviare l'output della pagina ASP.NET core in Redis

Per una specifica completa delle funzionalità, vedere memorizzazione nella cache dell'output di ASP.NET core.

Per un'applicazione di esempio che illustra l'utilizzo, vedere Applicazione Web .NET 8 con memorizzazione nella cache di output Redis e Azure OpenAI.

Archiviare l'output della pagina ASP.NET in Redis

Per configurare un'applicazione client in Visual Studio con il pacchetto NuGet dello Stato sessione della cache di Azure per Redis, selezionare Gestione pacchetti NuGet, Console di Gestione pacchetti dal menu Strumenti.

Eseguire questo comando nella finestra Package Manager Console:

Install-Package Microsoft.Web.RedisOutputCacheProvider

Il pacchetto NuGet del provider di cache di output Redis ha una dipendenza dal pacchetto StackExchange.Redis. Se il pacchetto StackExchange.Redis non è presente nel progetto, viene installato. Per altre informazioni sul pacchetto NuGet provider di cache Redis di output, vedere la pagina di NuGet su RedisOutputCacheProvider.

Il pacchetto NuGet scarica e aggiunge i riferimenti all'assembly richiesto e aggiunge la sezione seguente al file web.config. Questa sezione contiene la configurazione richiesta dall'applicazione ASP.NET per usare il provider di cache di output Redis.

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

Configurare gli attributi nella prima colonna con i valori della cache nel portale di Microsoft Azure. Configurare anche gli altri valori desiderati. Per istruzioni sull'accesso alle proprietà della cache, vedere Configurare le impostazioni di Cache Redis di Azure.

Note sull'attributo

Impostazione di connectionString

Il valore di connectionString viene usato come chiave per recuperare la stringa di connessione effettiva da AppSettings, se tale stringa esiste in AppSettings. Se non viene trovata in AppSettings, il valore di connectionString viene usato come chiave per recuperare la stringa di connessione effettiva dalla sezione ConnectionString di web.config, se tale sezione esiste. Se la stringa di connessione non esiste in AppSettings o nella sezione ConnectionString di web.config, il valore letterale di connectionString viene usato come stringa di connessione durante la creazione di StackExchange.Redis.ConnectionMultiplexer.

Gli esempi seguenti illustrano come viene usato connectionString.

Esempio 1

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

In web.config, usare la chiave come valore del parametro anziché come valore effettivo.

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

Esempio 2

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

In web.config, usare la chiave come valore del parametro anziché come valore effettivo.

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

Esempio 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>

Note su throwOnError

Al momento, se si verifica un errore durante un'operazione di sessione, il provider dello Stato della sessione genera un'eccezione. La generazione dell'eccezione arresta l'applicazione.

Questo comportamento è stato modificato in modo da supportare le aspettative degli utenti del provider dello Stato sessione ASP.NET esistenti, consentendo allo stesso tempo di agire sulle eccezioni. Il comportamento predefinito genera comunque un'eccezione quando si verifica un errore, coerente con altri provider dello Stato della sessione ASP.NET. Il codice esistente dovrebbe funzionare come in precedenza.

Se si imposta throwOnError su False, invece di generare un'eccezione quando si verifica un errore, l'operazione ha esito negativo automaticamente. Per controllare se si è verificato un errore e, in tal caso, individuare l'eccezione, controllare la proprietà statica Microsoft.Web.Redis.RedisSessionStateProvider.LastException.

Note su retryTimeoutInMilliseconds

L'impostazione retryTimeoutInMilliseconds fornisce una logica per semplificare il caso in cui un'operazione di sessione debba riprovare in caso di errore a causa di un problema temporaneo rete o di altro tipo. L'impostazione retryTimeoutInMilliseconds consente anche di controllare il timeout di ripetizione dei tentativi o di rifiutare esplicitamente il nuovo tentativo.

Se si imposta retryTimeoutInMilliseconds su un numero, ad esempio 2000, quando un'operazione di sessione non riesce, viene eseguito un nuovo tentativo per 2.000 millisecondi prima di considerarlo come errore. Per fare in modo che il provider di stato della sessione applichi questa logica di ripetizione dei tentativi, basta configurare il timeout. Il primo tentativo verrà eseguito dopo 20 millisecondi, che è un temo sufficiente nella maggior parte dei casi quando si verifica un errore di rete. Successivamente, verrà eseguito un nuovo tentativo ogni secondo fino a quando non si verifica il timeout. Subito dopo il timeout, verrà eseguito un nuovo tentativo per assicurarsi che il timeout non venga tagliato di un secondo (al massimo).

Se non si ritiene necessario riprovare o se si vuole gestire manualmente la logica di ripetizione dei tentativi, impostare retryTimeoutInMilliseconds su 0. Ad esempio, potrebbe non essere necessario riprovare quando si esegue il server Redis nello stesso computer dell'applicazione.

Informazioni su redisSerializerType

La serializzazione per archiviare i valori in Redis viene eseguita in un formato binario per impostazione predefinita, fornito dalla classe BinaryFormatter . Usare redisSerializerType per specificare il nome del tipo qualificato dell'assembly di una classe che implementa Microsoft.Web.Redis.ISerializer e dispone della logica personalizzata per serializzare e deserializzare i valori. Ad esempio, ecco una classe del serializzatore JSON che usa 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);
        }
    }
}

Supponendo che questa classe sia definita in un assembly con nome MyCompanyDll, è possibile impostare il parametro redisSerializerType per usarla:

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

Direttiva cache di output

Aggiungere una direttiva OutputCache a ogni pagina per cui si desidera memorizzare l'output nella cache.

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

Nell'esempio precedente, i dati delle pagine rimangono memorizzati nella cache per 60 secondi e per ogni combinazione di parametri viene memorizzata nella cache una versione diversa della pagina. Per altre informazioni sulla direttiva OutputCache, vedere @outputCache.

Dopo aver eseguito questi passaggi, l'applicazione è configurata per l'uso del provider di cache di output Redis.

Provider di cache di output di terze parti

• NCache
• Apache Ignite

Contenuto correlato

Vedere Provider di stato sessione ASP.NET per Cache Redis di Azure.