Sys.Net.WebRequest userContext-Eigenschaft
Aktualisiert: November 2007
Ruft den der Sys.Net.WebRequest-Instanz zugeordneten Benutzerkontext ab oder legt ihn fest.
Tipp
Um Eigenschaftenwerte für Client-API-Eigenschaften abzurufen oder festzulegen, müssen Sie Accessormethoden für die Eigenschaften aufrufen, die mit dem Präfix get_ bzw. set_ benannt sind. Beispiel: Um einen Wert für eine Eigenschaft wie cancel abzurufen oder festzulegen, rufen Sie die get_cancel-Methode oder die set_cancel-Methode auf.
var userContext = MyWebRequest.get_userContext();
MyWebRequest.set_userContext(value);
Parameter
Parameter |
Beschreibung |
|---|---|
Value |
Die Benutzerkontextinformationen, die der Anforderung zugeordnet sind. value kann null, ein primitiver Typ oder ein JavaScript-Objekt sein. |
Rückgabewert
Der aktuelle Benutzerkontext für die Webanforderung.
Hinweise
Die userContext-Eigenschaft kann vor dem Aufrufen ihrer invoke-Methode auf die WebRequest-Instanz festgelegt werden. Auf dieselbe userContext-Eigenschaft kann innerhalb des abgeschlossenen Handlers der Webanforderung zugegriffen werden. Dadurch kann zwischen Aufrufern für Ereignishandler unterschieden oder bei der Verarbeitung der zurückgegebenen Daten Zustand und Kontext wiederhergestellt werden.
Tipp
Um den Benutzerkontext innerhalb des Ereignishandlers abzurufen, verwenden Sie den Benutzerkontext von Sys.Net.WebRequestExecutor webRequest-Eigenschaft.
Beispiel
Im folgenden Beispiel wird gezeigt, wie Sie den Benutzerkontext für die Webanforderung festlegen. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die WebRequest-Klasse enthalten ist.
// Set user's context
wRequest.set_userContext("user's context");
Siehe auch
Referenz
Sys.Net.WebRequestManager-Klasse