CookieHandler Klass

Definition

Namnområde:
System.IdentityModel.Services
Sammansättning:
System.IdentityModel.Services.dll

Tillhandahåller en abstrakt basklass för läsning, skrivning och borttagning av sessionscookies på en HTTP-klient.

public ref class CookieHandler abstract
public abstract class CookieHandler
type CookieHandler = class
Public MustInherit Class CookieHandler
Arv
Object
CookieHandler
Härledda

Exempel

I följande exempel konfigureras SAM att använda en anpassad cookiehanterare av typen MyNamespace.MyCustomCookieHandler.

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

Kommentarer

SessionAuthenticationModule (SAM) använder en instans av CookieHandler klassen för att läsa, skriva och ta bort cookien eller cookies som innehåller SessionSecurityToken på HTTP-klienten. Cookien (eller cookies, om sessionstoken delas upp i flera cookies) som innehåller sessionstoken kallas sessionscookie.

Windows Identity Foundation (WIF) levereras med en cookiehanterare som kallas segmenterad cookiehanterare som implementeras av klassen ChunkedCookieHandler. Den segmenterade cookiehanteraren delar upp sessionstoken över en eller flera cookies enligt en angiven segmentstorlek. Detta för att uppfylla storleksbegränsningar för enskilda cookies som införts av många webbläsare.

Du kan härleda från CookieHandler för att skapa en egen cookiehanterare. När du gör det måste du åsidosätta DeleteCoremetoderna , ReadCoreoch WriteCore för att utföra det faktiska arbetet med att ta bort, läsa och skriva sessionscookien. Dessa metoder läser vanligtvis cookien HttpRequest.Cookies från samlingen och skriver eller tar bort cookies via HttpResponse.Cookies samlingen. Det HttpContext objekt genom vilket du kan komma åt begäran och svaret tillhandahålls som en parameter för var och en av dessa metoder. Förutom de metoder som krävs kan du åsidosätta andra egenskaper för virtuella metoder som exponeras av CookieHandler klassen för att anpassa hanterarens beteende.

Flera egenskaper exponeras av klassen CookieHandler som anger standardbeteende och egenskaper för sessionscookien. Egenskaperna Name, Domainoch Path anger basnamnet för cookien, domänen där den är giltig och sökvägen under vilken den lagras på klienten. Egenskapen HideFromClientScript anger om cookien är tillgänglig för skript på klientsidan. Egenskapen RequireSsl anger om cookien endast ska överföras via säkra anslutningar (HTTPS). Om värdet PersistentSessionLifetime anges används egenskapen för att ange förfallotiden för beständiga sessioner, det vill:s för sessioner som förblir giltiga även efter att webbläsaren har stängts. Alla dessa egenskaper har motsvarande egenskaper som vanligtvis anges för det underliggande HttpCookie objektet (eller objekten) med hjälp av hanterarens "kärnmetoder". Mer information finns i dokumentationen för varje egenskap.

Cookiehanteraren som används av SAM kan anges i konfigurationen <via cookieHandler-elementet> . Cookiehanteraren som anges av det här elementet kan ändras i ett händelsedelegat för FederatedAuthentication.FederationConfigurationCreated händelsen eller så kan den anges eller nås direkt via SessionAuthenticationModule.CookieHandler egenskapen.

Konstruktorer

Name Description
CookieHandler()

Anropas från konstruktorer i härledda klasser för att initiera CookieHandler klassen.

Egenskaper

Name Description
Domain

Hämtar eller anger domänen som används för cookies.
HideFromClientScript

Hämtar eller anger ett värde som anger om cookien ska döljas från klientskriptet.
Name

Hämtar eller anger basnamnet för cookies som skrivits av hanteraren.
Path

Hämtar eller anger den virtuella sökvägen för cookies som skrivits av hanteraren.
PersistentSessionLifetime

Livslängden för beständiga sessioner. Om noll används alltid tillfälliga sessioner.
RequireSsl

Hämtar eller anger ett värde som anger om cookien endast ska användas med SSL.

Metoder

Name Description
Delete()

Tar bort den cookie som är associerad med den aktuella begäran som har standardnamnet, domänen och sökvägen.
Delete(HttpContext)

Tar bort den cookie som är associerad med den aktuella begäran som har standardnamnet, domänen och sökvägen.
Delete(String, HttpContext)

Tar bort den cookie som är associerad med den angivna begäran som har det angivna namnet och standarddomänen och sökvägen.
Delete(String, String, String, HttpContext)

Tar bort den cookie som är associerad med den angivna begäran som har det angivna namnet, sökvägen och domänen.
Delete(String)

Tar bort den cookie som är associerad med den aktuella begäran som har det angivna namnet och standarddomänen och sökvägen.
DeleteCore(String, String, String, HttpContext)

När den åsidosätts i en härledd klass tar den cookie som är associerad med den angivna begäran som har det angivna namnet, domänen och sökvägen bort.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MatchCookiePath(Uri, Uri)

Om måldomänen finns inom cookiedomänen och målsökvägen finns inom cookiesökvägen matchar du höljet för cookiesökvägsdelen.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Read()

Läser cookien som är associerad med den aktuella begäran som har standardnamnet.
Read(HttpContext)

Läser cookien som är associerad med den aktuella begäran som har standardnamnet, domänen och sökvägen.
Read(String, HttpContext)

Läser cookien som är associerad med den angivna begäran som har det angivna namnet och standarddomänen och sökvägen.
Read(String)

Läser cookien som är associerad med den aktuella begäran som har det angivna namnet.
ReadCore(String, HttpContext)

När den åsidosätts i en härledd klass läser den cookie som har det angivna namnet och som är associerad med den angivna begäran.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
Write(Byte[], Boolean, DateTime)

Skriver en cookie som är associerad med den aktuella begäran som har det angivna värdet, beständigheten och förfallotiden.
Write(Byte[], String, DateTime, HttpContext)

Skriver en cookie som är associerad med den angivna begäran som har det angivna namnet, värdet och förfallotiden.
Write(Byte[], String, DateTime)

Skriver en cookie som är associerad med den aktuella begäran som har det angivna namnet, värdet och förfallotiden.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

Skriver en cookie som är associerad med den angivna begäran som har det angivna namnet, värdet, domänen, sökvägen, förfallotiden och synligheten.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

När den åsidosätts i en härledd klass skriver en cookie som är associerad med den angivna begäran som har det angivna namnet, värdet, domänen, sökvägen, förfallotiden, beständigheten och synligheten.

Gäller för

Se även