CookieHandler Klasse

Referenz

Definition

Namespace:: System.IdentityModel.Services

Assembly:: System.IdentityModel.Services.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine abstrakte Basisklasse zum Lesen, Schreiben und Löschen von Sitzungscookies auf einem HTTP-Client bereit.

public ref class CookieHandler abstract

public abstract class CookieHandler

type CookieHandler = class

Public MustInherit Class CookieHandler

Vererbung: Object
CookieHandler

Abgeleitet: System.IdentityModel.Services.ChunkedCookieHandler

Beispiele

Im folgenden Beispiel wird das SAM für die Verwendung eines benutzerdefinierten Cookiehandlers vom Typ MyNamespace.MyCustomCookieHandlerkonfiguriert.

<cookieHandler mode="Custom">  
    <customCookieHandler type="MyNamespace.MyCustomCookieHandler, MyAssembly" />  
</cookieHandler>

Hinweise

Der SessionAuthenticationModule (SAM) verwendet eine instance der -Klasse, um das CookieHandler Cookie oder die Cookies zu lesen, zu schreiben und zu löschen, die auf SessionSecurityToken dem HTTP-Client enthalten. Das Cookie (oder Cookies, wenn das Sitzungstoken auf mehrere Cookies aufgeteilt wird), das das Sitzungstoken enthält, wird als Sitzungscookies bezeichnet.

Windows Identity Foundation (WIF) wird mit einem Cookiehandler namens dem Handler für segmentierte Cookies ausgeliefert, der von der ChunkedCookieHandler -Klasse implementiert wird. Der Handler für segmentierte Cookies teilt das Sitzungstoken gemäß einer angegebenen Blockgröße auf ein oder mehrere Cookies auf. Dies ist, um Größenbeschränkungen für einzelne Cookies zu erfüllen, die von vielen Browsern auferlegt werden.

Sie können von CookieHandler abgeleitet werden, um Einen eigenen Cookiehandler zu erstellen. In diesem Fall müssen Sie die DeleteCoreMethoden , ReadCoreund WriteCore überschreiben, um die eigentliche Arbeit des Löschens, Lesens und Schreibens des Sitzungscookies auszuführen. Diese Methoden lesen in der Regel das Cookie aus der HttpRequest.Cookies Sammlung und schreiben oder löschen Cookies über die HttpResponse.Cookies Sammlung. Das HttpContext Objekt, über das Sie auf die Anforderung und Antwort zugreifen können, wird als Parameter für jede dieser Methoden bereitgestellt. Zusätzlich zu den erforderlichen Methoden können Sie optional andere Eigenschaften virtueller Methoden überschreiben, die von der CookieHandler -Klasse verfügbar gemacht werden, um das Verhalten des Handlers anzupassen.

Mehrere Eigenschaften werden von der -Klasse verfügbar gemacht, die CookieHandler das Standardverhalten und die Eigenschaften für das Sitzungscookies angeben. Die NameEigenschaften , Domainund Path geben den Basisnamen für das Cookie, die Domäne, in der es gültig ist, und den Pfad an, unter dem es auf dem Client gespeichert wird. Die HideFromClientScript -Eigenschaft gibt an, ob clientseitige Skripts auf das Cookie zugreifen können. Die RequireSsl -Eigenschaft gibt an, ob das Cookie nur über sichere (HTTPS)-Verbindungen übertragen werden soll. Wenn festgelegt, wird die PersistentSessionLifetime -Eigenschaft verwendet, um die Ablaufzeit für persistente Sitzungen festzulegen, d. h. für Sitzungen, die auch nach dem Schließen des Browsers gültig bleiben. Alle diese Eigenschaften verfügen über gleichwertige Eigenschaften, die normalerweise für das zugrunde liegende HttpCookie Objekt (oder objekte) durch die "core"-Methoden des Handlers festgelegt werden. Weitere Informationen finden Sie in der Dokumentation zu den einzelnen Eigenschaften.

Der vom SAM verwendete Cookiehandler kann in der Konfiguration über das <cookieHandler-Element> angegeben werden. Der von diesem Element festgelegte Cookiehandler kann in einem Ereignisdelegat für das FederatedAuthentication.FederationConfigurationCreated Ereignis geändert werden, oder er kann über die SessionAuthenticationModule.CookieHandler -Eigenschaft festgelegt oder direkt darauf zugegriffen werden.

Konstruktoren

CookieHandler()

Wird von Konstruktoren in abgeleiteten Klassen aufgerufen, um die CookieHandler-Klasse zu initialisieren.

Eigenschaften

Domain	Ruft die Domäne, die für Cookies verwendet wird ab, bzw. legt diese fest.
HideFromClientScript	Ruft einen Wert ab, der angibt, ob das Cookie aus dem Clientskript ausgeblendet werden soll, oder legt diesen Wert fest.
Name	Ruft den Basisnamen für Cookies ab, die vom Handler geschrieben wurden, oder legt diesen fest.
Path	Ruft den virtuellen Pfad für vom Handler geschriebene Cookies ab oder legt diesen fest.
PersistentSessionLifetime	Die Lebensdauer permanenter Sitzungen. Bei Null werden immer flüchtige Sitzungen verwendet.
RequireSsl	Ruft einen Wert ab, der angibt, ob das Cookie nur mit SSL verwendet werden soll, oder legt diesen fest.

Methoden

Delete()	Löscht den Cookie, der der aktuellen Anforderung zugeordnet wird, die über den Standardnamen, die Domäne und den Pfad verfügt.
Delete(HttpContext)	Löscht den Cookie, der der aktuellen Anforderung zugeordnet wird, die über den Standardnamen, die Domäne und den Pfad verfügt.
Delete(String)	löscht den Cookie, der der aktuellen Anforderung zugeordnet ist, die über den angegebenen Namen sowie die Standarddomäne und den Pfad verfügt.
Delete(String, HttpContext)	Löscht den Cookie, der der angegebenen Anforderung zugeordnet ist, die über den angegebenen Namen sowie die Standarddomäne und den Pfad verfügt.
Delete(String, String, String, HttpContext)	Löscht den Cookie, der der angegebenen Anforderung zugeordnet wird, die über den angegebenen Namen, die Domäne und den Pfad verfügt.
DeleteCore(String, String, String, HttpContext)	Löscht beim Überschreiben in einer abgeleiteten Klasse das Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen und die Domäne und den Pfad besitzt.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MatchCookiePath(Uri, Uri)	Wenn die Zieldomäne innerhalb der Cookiedomäne und der Zielpfad im Cookiepfad liegt, müssen Sie die Groß-/Kleinschreibung für die Angabe des Cookiepfads beachten.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Read()	Liest den Cookie, der der aktuellen Anforderung zugeordnet wird, die über den Standardnamen verfügt.
Read(HttpContext)	Liest den Cookie, der der aktuellen Anforderung zugeordnet wird, die über den Standardnamen, die Domäne und den Pfad verfügt.
Read(String)	Liest den Cookie, der der aktuellen Anforderung zugeordnet wird, die über den angegebenen Namen verfügt.
Read(String, HttpContext)	Liest den Cookie, der der angegebenen Anforderung zugeordnet ist, die über den angegebenen Namen sowie die Standarddomäne und den Pfad verfügt.
ReadCore(String, HttpContext)	Liest beim Überschreiben in einer abgeleiteten Klasse das Cookie, das den angegebenen Namen hat und welches der angegebenen Anforderung zugeordnet ist.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Write(Byte[], Boolean, DateTime)	Schreibt ein Cookie, das der aktuellen Anforderung zugeordnet ist, die den angegebenen Wert, die angegebene Dauerhaftigkeit und die angegebene Ablaufzeit hat.
Write(Byte[], String, DateTime)	Schreibt ein Cookie, das der aktuellen Anforderung zugeordnet ist, die den angegebenen Namen, den angegebenen Wert und die angegebene Ablaufzeit hat.
Write(Byte[], String, DateTime, HttpContext)	Schreibt ein Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen, den angegebenen Wert und die angegebene Ablaufzeit hat.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Schreibt ein Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen, den angegebenen Wert, Domäne, Pfad und die angegebene Ablaufzeit und Sichtbarkeit hat.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen, Wert, Domäne, Pfad und Ablaufzeit, Dauerhaftigkeit und Sichtbarkeit besitzt.

Gilt für: