SessionStateStoreProviderBase.GetItem Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce dati di sola lettura relativi allo stato sessione 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
Oggetto HttpContext 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, altrimenti contiene il valore false
.
- lockAge
- TimeSpan
Quando termina, questo metodo contiene un oggetto TimeSpan impostato sull'intervallo di tempo durante il quale un elemento dell'archivio dati della sessione risulta 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 dell'archivio di sessione" nel riepilogo della classe SessionStateStoreProviderBase.
- actions
- SessionStateActions
Quando termina, questo metodo contiene uno dei valori dell'oggetto SessionStateActions che indica se la sessione corrente è una sessione senza cookie non inizializzata.
Restituisce
Oggetto SessionStateStoreData nel quale vengono inseriti i valori e le informazioni sulla sessione contenuti nell'archivio dati della sessione.
Esempio
Per un esempio di implementazione del provider di archiviazione con stato sessione, vedere Implementazione di un provider di archiviazione Session-State.
Commenti
L'oggetto chiama il GetItem metodo all'inizio di una richiesta, durante l'evento, quando l'attributo AcquireRequestStateEnableSessionState è impostato su ReadOnly
.SessionStateModule Se l'attributo è impostato su true
, l'oggetto EnableSessionStateSessionStateModule chiama invece il GetItemExclusive metodo .
Il GetItem metodo restituisce un SessionStateStoreData oggetto popolato con informazioni sulla sessione dall'archivio dati e aggiorna la data di scadenza dei dati della sessione. Se non vengono trovati dati dell'elemento sessione nell'archivio dati, il GetItem metodo imposta il locked
out
parametro su false
e restituisce null
. In questo modo l'oggetto chiama il SessionStateModuleCreateNewStoreData metodo per creare un nuovo elemento di sessione nell'archivio dati.
Se i dati degli elementi di sessione vengono trovati nell'archivio dati, ma i dati vengono bloccati, il GetItem metodo imposta il parametro su true
, imposta il lockAge
out
out
locked
parametro sulla data e sull'ora corrente meno la data e l'ora in cui l'elemento è stato bloccato (che viene recuperato dall'archivio dati), imposta il lockId
out
parametro sull'identificatore di blocco recuperato dall'archivio dati, e restituisce null
. In questo modo l'oggetto chiama nuovamente il GetItem metodo dopo un intervallo di metà secondo per tentare di recuperare le informazioni sull'elemento SessionStateModule sessione.
Se il lockAge
out
valore impostato ExecutionTimeout sul parametro supera il valore, l'oggetto SessionStateModule chiama il ReleaseItemExclusive metodo per cancellare il blocco sui dati dell'elemento sessione e quindi chiama di nuovo il GetItem metodo.
Il actionFlags
parametro viene usato quando entrambi gli cookieless
attributi e regenerateExpiredSessionId
vengono impostati su true
. Un actionFlags
valore impostato su InitializeItem indica che la voce nell'archivio dati sessione è una nuova sessione che richiede l'inizializzazione. Le voci non inizializzate nell'archivio CreateUninitializedItem dati sessione vengono create da una chiamata al metodo . Se l'elemento dall'archivio dati sessione non è un elemento non inizializzato, il actionFlags
parametro verrà impostato su zero.
Gli implementer dello stato sessione personalizzati che supportano le sessioni senza cookie devono impostare il actionFlags
out
parametro sul valore restituito dall'archivio dati della sessione per l'elemento corrente. Se il actionFlags
valore del parametro per l'elemento dell'archivio sessioni richiesto è uguale InitializeItem al valore di enumerazione, il GetItem metodo deve impostare il valore nell'archivio dati su zero dopo l'impostazione del actionFlags
out
parametro.
Si applica a
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per