Condividi tramite

Impostazioni di configurazione per il provider di stato della sessione di memorizzazione nella cache di ASP.NET 4 (Memorizzazione nella cache di AppFabric 1.1)

  • Articolo

In questo argomento vengono illustrate le impostazioni di configurazione relative al provider di stato della sessione di AppFabric per ASP.NET. Queste impostazioni sono specificate nella sezione providers dell'elemento sessionState nel file web.config.

Impostazioni di configurazione relative allo stato della sessione

Attributo Descrizione

name (obbligatorio)

Nome descrittivo utilizzato dall'elemento sessionState per fare riferimento al provider.

type (obbligatorio)

Stringa type di .NET Framework per il provider. Deve essere impostata su “Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache”.

cacheName (obbligatorio)

Nome della cache di AppFabric.

dataCacheClientName (facoltativo)

Nome della sezione dataCacheClient da utilizzare dalla sezione di configurazione dataCacheClients. Questo attributo è obbligatorio solo se nel file web.config sono specificate più sezioni dataCacheClient. Per impostazione predefinita, il provider utilizzerà la sezione dataCacheClient denominata “default”.

applicationName (facoltativo)

Valore stringa utilizzato dal provider durante la creazione delle chiavi della cache per la memorizzazione dei dati di stato della sessione. Se l'attributo non è impostato, lo stato della sessione viene condiviso solo tra diverse istanze fisiche della stessa applicazione Web (con il requisito aggiuntivo che ciascuna istanza dell'applicazione viene installata con lo stesso percorso di metabase IIS). Per ulteriori informazioni, vedere https://support.microsoft.com/kb/325056. Se l'attributo è impostato, lo stato della sessione verrà condiviso tra tutte le applicazioni Web che utilizzano lo stesso valore di applicationName.

useBlobMode (facoltativo)

Valore booleano che specifica se i dati di stato della sessione devono essere caricati e memorizzati come un unico BLOB serializzato. Il valore predefinito è true. Se è impostato il valore false, il provider carica e memorizza i dati di stato della sessione come coppie di chiavi singole.

nonInlinedAdditionalLifetime (facoltativo)

Intervallo di tempo utilizzato dal provider per rilevare il momento successivo in cui un singolo elemento dello stato della sessione (non inline) deve essere toccato per mantenere lo stato attivo. Questo valore viene utilizzato solo quando useBlobMode è impostato su false. Il valore predefinito corrisponde al 50% del valore di timeout, espresso in secondi, dello stato della sessione di configurazione. Il formato della stringa da utilizzare per questo valore è "HH:MM:SS". Ad esempio, dieci minuti sarà scritto nel formato "00:10:00". È possibile diminuire questo valore in modo da ridurre la quantità di elementi temporali associati alle sessioni scadute che rimangono nella cache.

retryInterval (facoltativo)

Intervallo di tempo di attesa tra i tentativi di ripetizione di un'operazione in caso di errore di comunicazione con la cache. Il formato della stringa da utilizzare per questo valore è "HH:MM:SS". Per impostazione predefinita, verrà attivata la modalità di sospensione del provider per un secondo.

retryCount (facoltativo)

Valore intero che indica al provider il numero di tentativi di ripetizione di un'operazione in caso di errore di comunicazione con la cache. I tentativi di ripetizione possono essere effettuati solo per alcune operazioni. Il valore predefinito è tre. Nell'intervallo di tempo configurato in retryInterval tra ciascun tentativo di ripetizione viene attivata la modalità di sospensione del provider.

inlinedKeys (facoltativo)

Valore stringa contenente un set di chiavi di stato della sessione delimitato da virgole o punti e virgola, i cui valori devono essere inseriti inline nel record dei metadati dello stato della sessione. Questa impostazione è valida solo quando useBlobMode è impostato su false. È possibile utilizzare questa impostazione come strumento di ottimizzazione per ridurre il numero di round trip di accesso alla cache per gli elementi dello stato della sessione molto utilizzati.

maxInlinedStringLength (facoltativo)

Valore intero che indica la dimensione massima della stringa di un valore dello stato della sessione che verrà automaticamente inserito inline nel record dei metadati dello stato della sessione. Questa impostazione è valida solo quando useBlobMode è impostato su false. Il valore predefinito delle stringhe è 512 caratteri.

Esempio

Nell'esempio riportato di seguito, l'elemento sessionState utilizza coppie chiave-valore singole per lo stato della sessione nonché un nome di applicazione condiviso.

<sessionState 
mode="Custom" 
customProvider="DistributedSessionProvider">
      <providers>
        <add name="DistributedSessionProvider"
             type="Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, 
     Microsoft.Web.DistributedCache"
             cacheName="default"
             applicationName="Contoso"
             useBlobMode="true" />
      </providers>
</sessionState>

Vedere anche

Concetti

Provider di stato della sessione (Memorizzazione nella cache di AppFabric 1.1)

  2012-03-05