Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SessionStateStoreProviderBase.GetItemExclusive-Methode: (HttpContext, String, Boolean, TimeSpan, Object, SessionStateActions)

 

Veröffentlicht: Oktober 2016

Gibt schreibgeschützte Sitzungszustandsdaten vom Sitzungsdatenspeicher zurück.

Namespace:   System.Web.SessionState
Assembly:  System.Web (in System.Web.dll)

public abstract SessionStateStoreData GetItemExclusive(
	HttpContext context,
	string id,
	out bool locked,
	out TimeSpan lockAge,
	out object lockId,
	out SessionStateActions actions
)

Parameter

context
Type: System.Web.HttpContext

Die HttpContext für die aktuelle Anforderung.

id
Type: System.String

Die SessionID für die aktuelle Anforderung.

locked
Type: System.Boolean

Bei der Rückgabe dieser Methode enthält einen booleschen Wert, der festgelegt wird, um true ist eine Sperre erfolgreich abgerufen wurde; andernfalls false.

lockAge
Type: System.TimeSpan

Diese Methode gibt ein TimeSpan -Objekt, das auf die Zeitdauer festgelegt ist, der ein Element im Sitzungsdatenspeicher gesperrt wurde.

lockId
Type: System.Object

Enthält nach dem Beenden dieser Methode ein Objekt, das auf den Bezeichner der Sperre für die aktuelle Anforderung festgelegt ist. Ausführliche Informationen über Bezeichner der Sperre, finden Sie unter "Locking Sitzungsspeicher" in der SessionStateStoreProviderBase Zusammenfassung der-Klasse.

actions
Type: System.Web.SessionState.SessionStateActions

Enthält bei der Rückgabe dieser Methode einen von der SessionStateActions Werte, der angibt, ob die aktuelle Sitzung eine nicht initialisierte Sitzung ohne Cookies ist.

Rückgabewert

Type: System.Web.SessionState.SessionStateStoreData

Ein SessionStateStoreData mit Sitzungswerten und Informationen aus dem Sitzungsdatenspeicher aufgefüllt.

Die SessionStateModule -Objekt ruft die GetItemExclusive -Methode zu Beginn einer Anforderung während der AcquireRequestState Ereignis, wenn die EnableSessionState Attribut festgelegt ist true, dies ist die Standardeinstellung. Wenn die EnableSessionState -Attributsatz zur ReadOnly, die SessionStateModule -Objekt stattdessen Ruft die GetItem Methode.

Die GetItemExclusive -Methode gibt ein SessionStateStoreData Objekt, das mit Sitzungsinformationen aus dem Datenspeicher und aktualisiert das Ablaufdatum der gespeicherten Daten und sperrt die Sitzungselement Daten im Datenspeicher für die Dauer der Anforderung. Wenn keine Sitzung-Element-Daten im Datenspeicher gefunden werden die GetItemExclusive -Methode legt die locked out Parameter false und gibt null Dies bewirkt, dass die SessionStateModule -Objekt, rufen Sie die CreateNewStoreData Methode, um ein neues Sitzungselement im Datenspeicher zu erstellen. Wenn Sitzungselement Daten im Datenspeicher gefunden werden, aber die Daten gesperrt ist, die GetItemExclusive -Methode legt die locked out Parameter, um true, legt die lockAge out Parameter auf das aktuelle Datum und die Uhrzeit abzüglich des Datums und der Zeit, wenn das Element gesperrt wurde (die aus dem Datenspeicher abgerufen wird), setzt der lockId out Parameter für den Sperrbezeichner abgerufen wird, aus dem Datenspeicher und gibt null.    Dies bewirkt, dass die SessionStateModule -Objekt, rufen Sie die GetItemExclusive Methode erneut nach einer halben Sekunde versuchen, die Sitzungselementinformationen abzurufen und eine Sperre auf die Daten. Wenn der Wert, der lockAge out Parametersatz überschreitet die ExecutionTimeout Wert, der SessionStateModule Aufrufe der ReleaseItemExclusive Methode, um die Sperre für die Sitzung-Daten, und ruft dann Löschen der GetItemExclusive -Methode erneut. 

Die actionFlags Parameter wird verwendet, wenn die cookieless und regenerateExpiredSessionId Attribute festgelegt sind true. Ein actionFlags Wert InitializeItem Gibt an, dass der Eintrag im Sitzungsdatenspeicher eine neue Sitzung, die initialisiert werden muss. Nicht initialisierte Einträge in den Sitzungsdaten werden erstellt, durch einen Aufruf der CreateUninitializedItem Methode. Wenn das Element aus dem Datenspeicher für die Sitzung nicht initialisiert, ist der actionFlags -Parameter wird auf 0 (null) festgelegt werden.

Benutzerdefinierte Sitzungszustandsspeicher-Implementierer, die Cookies Sitzungen unterstützen sollten Festlegen der actionFlags out Parameter an den Wert aus dem Sitzungsdatenspeicher für das aktuelle Element zurückgegeben.  Wenn die actionFlags Parameterwert für den angeforderten Sitzungsspeicher gleich der InitializeItem -Enumerationswert, der GetItemExclusive Methode sollte legen Sie den Wert im Datenspeicher auf 0 (null), nach dem Festlegen der actionFlags out Parameter. 

Ein Beispiel für die Implementierung eines Sitzungszustandsspeicher-Anbieters, finden Sie unter Implementing a Session-State Store Provider.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: