CookieHandler Třída

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

Poskytuje abstraktní základní třídu pro čtení, zápis a odstraňování souborů cookie relace na klientovi HTTP.

public ref class CookieHandler abstract

public abstract class CookieHandler

type CookieHandler = class

Public MustInherit Class CookieHandler

Dědičnost

Object

CookieHandler

Odvozené

System.IdentityModel.Services.ChunkedCookieHandler

Příklady

Následující příklad nakonfiguruje SAM tak, aby používal vlastní obslužnou rutinu souboru cookie typu MyNamespace.MyCustomCookieHandler.

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

Poznámky

( SessionAuthenticationModule SAM) používá instanci třídy ke čtení, zápisu CookieHandler a odstranění souboru cookie nebo souborů cookie, které obsahují SessionSecurityToken soubor v klientovi HTTP. Soubor cookie (nebo soubory cookie, v případě, že je token relace rozdělený mezi několik souborů cookie), který obsahuje token relace, se označuje jako soubor cookie relace.

Windows Identity Foundation (WIF) se dodává s obslužnou rutinou souboru cookie označovanou jako blokovaná obslužná rutina souborů cookie, která je implementována ChunkedCookieHandler třídou. Obslužná rutina blokovaného souboru cookie rozdělí token relace mezi jeden nebo více souborů cookie podle zadané velikosti bloků dat. To je kvůli splnění omezení velikosti jednotlivých souborů cookie, které ukládá mnoho prohlížečů.

Můžete odvodit z CookieHandler vytvoření vlastní obslužné rutiny souboru cookie. Pokud to uděláte, musíte přepsat DeleteCoremetody , ReadCorea WriteCore , abyste mohli provádět skutečnou práci při odstraňování, čtení a zápisu souboru cookie relace. Tyto metody obvykle čtou soubor cookie z HttpRequest.Cookies kolekce a zapisují nebo odstraňují soubory cookie prostřednictvím HttpResponse.Cookies kolekce. Objekt HttpContext , přes který můžete získat přístup k požadavku a odpovědi, se poskytuje jako parametr pro každou z těchto metod. Kromě požadovaných metod můžete volitelně přepsat další vlastnosti virtuálních metod vystavených CookieHandler třídou a přizpůsobit tak chování obslužné rutiny.

Několik vlastností je zpřístupněno CookieHandler třídou, které určují výchozí chování a vlastnosti pro soubor cookie relace. Vlastnosti Name, Domaina Path poskytují základní název souboru cookie, doménu, ve které je platný, a cestu, pod kterou je uložen v klientovi. Vlastnost HideFromClientScript určuje, jestli je soubor cookie přístupný pro skripty na straně klienta. Vlastnost RequireSsl určuje, jestli se má soubor cookie přenášet pouze přes zabezpečená připojení (HTTPS). Pokud je tato vlastnost nastavená, PersistentSessionLifetime použije se k nastavení doby vypršení platnosti pro trvalé relace, tedy pro relace, které zůstanou platné i po zavření prohlížeče. Všechny tyto vlastnosti mají ekvivalentní vlastnosti, které jsou obvykle nastaveny na podkladový HttpCookie objekt (nebo objekty) "core" metody obslužné rutiny. Další informace najdete v dokumentaci k jednotlivým vlastnostem.

Obslužnou rutinu souboru cookie, kterou používá SAM, lze zadat v konfiguraci prostřednictvím elementu <cookieHandler> . Obslužnou rutinu souboru cookie nastavenou tímto prvkem lze upravit v delegátu FederatedAuthentication.FederationConfigurationCreated události nebo ji lze nastavit nebo získat přístup přímo prostřednictvím SessionAuthenticationModule.CookieHandler vlastnosti.

Konstruktory

CookieHandler()

Volá se z konstruktorů v odvozených třídách k inicializaci CookieHandler třídy.

Vlastnosti

Domain	Získá nebo nastaví doménu používanou pro soubory cookie.
HideFromClientScript	Získá nebo nastaví hodnotu, která označuje, zda soubor cookie má být skrytý v klientském skriptu.
Name	Získá nebo nastaví základní název pro soubory cookie napsané obslužnou rutinou.
Path	Získá nebo nastaví virtuální cestu pro soubory cookie zapsané obslužnou rutinou.
PersistentSessionLifetime	Životnost trvalých relací. Pokud je nula, vždy se použijí přechodné relace.
RequireSsl	Získá nebo nastaví hodnotu, která určuje, zda soubor cookie má být použit pouze s SSL.

Metody

Delete()	Odstraní soubor cookie přidružený k aktuálnímu požadavku, který má výchozí název, doménu a cestu.
Delete(HttpContext)	Odstraní soubor cookie přidružený k aktuálnímu požadavku, který má výchozí název, doménu a cestu.
Delete(String)	Odstraní soubor cookie přidružený k aktuálnímu požadavku, který má zadaný název a výchozí doménu a cestu.
Delete(String, HttpContext)	Odstraní soubor cookie přidružený k zadanému požadavku, který má zadaný název a výchozí doménu a cestu.
Delete(String, String, String, HttpContext)	Odstraní soubor cookie přidružený k zadanému požadavku, který má zadaný název, cestu a doménu.
DeleteCore(String, String, String, HttpContext)	Při přepsání v odvozené třídě odstraní soubor cookie přidružený k zadanému požadavku, který má zadaný název, doménu a cestu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MatchCookiePath(Uri, Uri)	Pokud se cílová doména nachází v doméně souboru cookie a cílová cesta je v cestě k souboru cookie, shodujte velikost písmen části cesty souboru cookie.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Read()	Přečte soubor cookie přidružený k aktuálnímu požadavku, který má výchozí název.
Read(HttpContext)	Přečte soubor cookie přidružený k aktuálnímu požadavku, který má výchozí název, doménu a cestu.
Read(String)	Přečte soubor cookie přidružený k aktuálnímu požadavku, který má zadaný název.
Read(String, HttpContext)	Přečte soubor cookie přidružený k zadanému požadavku, který má zadaný název a výchozí doménu a cestu.
ReadCore(String, HttpContext)	Při přepsání v odvozené třídě přečte soubor cookie, který má zadaný název a který je přidružen k zadanému požadavku.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Write(Byte[], Boolean, DateTime)	Zapíše soubor cookie přidružený k aktuálnímu požadavku, který má zadanou hodnotu, trvalost a dobu vypršení platnosti.
Write(Byte[], String, DateTime)	Zapíše soubor cookie přidružený k aktuálnímu požadavku, který má zadaný název, hodnotu a dobu vypršení platnosti.
Write(Byte[], String, DateTime, HttpContext)	Zapíše soubor cookie přidružený k zadanému požadavku, který má zadaný název, hodnotu a dobu vypršení platnosti.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Zapíše soubor cookie přidružený k zadanému požadavku se zadaným názvem, hodnotou, doménou, cestou, časem vypršení platnosti a viditelností.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Při přepsání v odvozené třídě zapíše soubor cookie přidružený k zadanému požadavku, který má zadaný název, hodnotu, doménu, cestu, dobu vypršení platnosti, trvalost a viditelnost.

Viz také

• ChunkedCookieHandler
• <obslužná rutina souboru cookie>