SessionStateStoreProviderBase.GetItem Metodo

Definizione

Spazio dei nomi:

System.Web.SessionState

Assembly:

System.Web.dll

Restituisce dati di stato sessione di sola lettura dall'archivio dati della sessione.

public:
 abstract System::Web::SessionState::SessionStateStoreData ^ GetItem(System::Web::HttpContext ^ context, System::String ^ id, [Runtime::InteropServices::Out] bool % locked, [Runtime::InteropServices::Out] TimeSpan % lockAge, [Runtime::InteropServices::Out] System::Object ^ % lockId, [Runtime::InteropServices::Out] System::Web::SessionState::SessionStateActions % actions);

public abstract System.Web.SessionState.SessionStateStoreData GetItem (System.Web.HttpContext context, string id, out bool locked, out TimeSpan lockAge, out object lockId, out System.Web.SessionState.SessionStateActions actions);

abstract member GetItem : System.Web.HttpContext * string * bool * TimeSpan * obj * SessionStateActions -> System.Web.SessionState.SessionStateStoreData

Public MustOverride Function GetItem (context As HttpContext, id As String, ByRef locked As Boolean, ByRef lockAge As TimeSpan, ByRef lockId As Object, ByRef actions As SessionStateActions) As SessionStateStoreData

Parametri

context

HttpContext

HttpContext per la richiesta corrente.

id

String

SessionID per la richiesta corrente.

locked

Boolean

Quando termina, questo metodo contiene un valore booleano impostato su true se l'elemento di sessione richiesto è bloccato nell'archivio dati della sessione; in caso contrario, false.

lockAge

TimeSpan

Quando termina, questo metodo contiene un oggetto TimeSpan impostato sulla quantità di tempo in cui un elemento nell'archivio dati della sessione è stato bloccato.

lockId

Object

Quando termina, questo metodo contiene un oggetto impostato sull'identificatore di blocco per la richiesta corrente. Per informazioni dettagliate sull'identificatore di blocco, vedere "Blocco dei dati Session-Store" nel riepilogo della classe SessionStateStoreProviderBase.

actions

SessionStateActions

Quando termina, questo metodo contiene uno dei valori SessionStateActions, che indica se la sessione corrente è una sessione non inizializzata senza cookie.

Restituisce

SessionStateStoreData

Un SessionStateStoreData popolato con valori di sessione e informazioni dall'archivio dati della sessione.

Esempio

Per un esempio di implementazione del provider dell'archivio stati sessione, vedere Implementazione di un provider di archiviazione Session-State.

Commenti

L'oggetto SessionStateModule chiama il metodo GetItem all'inizio di una richiesta, durante l'evento AcquireRequestState, quando l'attributo EnableSessionState è impostato su ReadOnly. Se l'attributo EnableSessionState è impostato su true, l'oggetto SessionStateModule chiama invece il metodo GetItemExclusive.

Il metodo GetItem restituisce un oggetto SessionStateStoreData popolato con informazioni sulla sessione dall'archivio dati e aggiorna la data di scadenza dei dati della sessione. Se nell'archivio dati non vengono trovati dati degli elementi di sessione, il metodo GetItem imposta il parametro lockedout su false e restituisce null. In questo modo, l'oggetto SessionStateModule chiama il metodo CreateNewStoreData per creare un nuovo elemento di sessione nell'archivio dati.

Se i dati dell'elemento di sessione vengono trovati nell'archivio dati ma i dati sono bloccati, il metodo GetItem imposta il parametro lockedout su true, imposta il parametro lockAgeout sulla data e sull'ora correnti meno la data e l'ora in cui l'elemento è stato bloccato (che viene recuperato dall'archivio dati), imposta il parametro lockIdout sull'identificatore di blocco recuperato dall'archivio dati, e restituisce null. In questo modo, l'oggetto SessionStateModule chiama nuovamente il metodo GetItem dopo un intervallo di mezzo secondo per tentare di recuperare le informazioni sull'elemento di sessione.

Se il valore impostato dal parametro lockAgeout supera il valore ExecutionTimeout, l'oggetto SessionStateModule chiama il metodo ReleaseItemExclusive per cancellare il blocco sui dati dell'elemento sessione e quindi chiama nuovamente il metodo GetItem.

Il parametro actionFlags viene usato quando entrambi gli attributi cookieless e regenerateExpiredSessionId vengono impostati su true. Un valore actionFlags impostato su InitializeItem indica che la voce nell'archivio dati della sessione è una nuova sessione che richiede l'inizializzazione. Le voci non inizializzate nell'archivio dati della sessione vengono create da una chiamata al metodo CreateUninitializedItem. Se l'elemento dall'archivio dati della sessione non è un elemento non inizializzato, il parametro actionFlags verrà impostato su zero.

Gli implementatori personalizzati dell'archivio dello stato sessione che supportano sessioni senza cookie devono impostare il parametro actionFlagsout sul valore restituito dall'archivio dati della sessione per l'elemento corrente. Se il valore del parametro actionFlags per l'elemento dell'archivio sessioni richiesto è uguale al valore di enumerazione InitializeItem, il metodo GetItem deve impostare il valore nell'archivio dati su zero dopo aver impostato il parametro actionFlagsout.

Vedi anche

• ASP.NET panoramica dello stato della sessione