CookieHandler Classe

Référence

Définition

Espace de noms:: System.IdentityModel.Services

Assembly:: System.IdentityModel.Services.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit une classe de base abstraite pour lire, écrire et supprimer des cookies de session sur un client HTTP.

public ref class CookieHandler abstract

public abstract class CookieHandler

type CookieHandler = class

Public MustInherit Class CookieHandler

Héritage: Object
CookieHandler

Dérivé: System.IdentityModel.Services.ChunkedCookieHandler

Exemples

L’exemple suivant configure sam pour utiliser un gestionnaire de cookies personnalisé de type MyNamespace.MyCustomCookieHandler.

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

Remarques

(SessionAuthenticationModuleSAM) utilise un instance de la CookieHandler classe pour lire, écrire et supprimer le ou les cookies qui contiennent le SessionSecurityToken sur le client HTTP. Le cookie (ou cookies, dans le cas où le jeton de session est divisé entre plusieurs cookies) qui contient le jeton de session est appelé cookie de session.

Windows Identity Foundation (WIF) est fourni avec un gestionnaire de cookies appelé gestionnaire de cookies segmenté implémenté par la ChunkedCookieHandler classe. Le gestionnaire de cookies segmenté fractionne le jeton de session entre un ou plusieurs cookies en fonction d’une taille de segment spécifiée. Il s’agit de répondre aux limitations de taille des cookies individuels imposées par de nombreux navigateurs.

Vous pouvez dériver de pour créer votre propre gestionnaire de CookieHandler cookies. Dans ce cas, vous devez remplacer les DeleteCoreméthodes , ReadCoreet WriteCore pour effectuer le travail réel de suppression, de lecture et d’écriture du cookie de session. Ces méthodes lisent généralement le cookie de la HttpRequest.Cookies collection et écrivent ou suppriment des cookies via la HttpResponse.Cookies collection. L’objet HttpContext via lequel vous pouvez accéder à la requête et à la réponse est fourni en tant que paramètre pour chacune de ces méthodes. En plus des méthodes requises, vous pouvez éventuellement remplacer d’autres propriétés de méthodes virtuelles exposées par la CookieHandler classe pour personnaliser le comportement de votre gestionnaire.

Plusieurs propriétés sont exposées par la classe qui spécifient le CookieHandler comportement et les propriétés par défaut du cookie de session. Les Namepropriétés , Domainet Path fournissent le nom de base du cookie, le domaine dans lequel il est valide et le chemin d’accès sous lequel il est stocké sur le client. La HideFromClientScript propriété spécifie si le cookie est accessible aux scripts côté client. La RequireSsl propriété spécifie si le cookie doit être transmis uniquement via des connexions sécurisées (HTTPS). Si elle est définie, la PersistentSessionLifetime propriété est utilisée pour définir le délai d’expiration des sessions persistantes, c’est-à-dire pour les sessions qui restent valides même après la fermeture du navigateur. Toutes ces propriétés ont des propriétés équivalentes qui sont généralement définies sur l’objet (ou les objets) sous-jacents HttpCookie par les méthodes « core » du gestionnaire. Pour plus d’informations, consultez la documentation relative à chaque propriété.

Le gestionnaire de cookies utilisé par sam peut être spécifié dans la configuration via l’élément <cookieHandler> . Le gestionnaire de cookies défini par cet élément peut être modifié dans un délégué d’événement pour l’événement FederatedAuthentication.FederationConfigurationCreated ou il peut être défini ou accessible directement via la SessionAuthenticationModule.CookieHandler propriété .

Constructeurs

CookieHandler()

Appelée à partir des constructeurs des classes dérivées pour initialiser la classe CookieHandler.

Propriétés

Domain	Obtient ou définit le domaine utilisé pour les cookies.
HideFromClientScript	Obtient ou définit une valeur qui indique si le cookie doit être masqué du script client.
Name	Obtient ou définit le nom de base pour les cookies écrits par le gestionnaire.
Path	Obtient ou définit le chemin d'accès virtuel pour les cookies écrit par le gestionnaire.
PersistentSessionLifetime	Durée de vie des sessions persistantes. Si la valeur est zéro, les sessions transitoires sont toujours utilisées.
RequireSsl	Obtient ou définit une valeur qui spécifie si le cookie doit être utilisé uniquement avec SSL.

Méthodes

Delete()	Supprime le cookie associé à la demande actuelle avec le nom, le champ et le chemin d'accès par défaut.
Delete(HttpContext)	Supprime le cookie associé à la demande actuelle avec le nom, le champ et le chemin d'accès par défaut.
Delete(String)	Supprime le cookie associé à la demande actuelle avec le nom spécifié, le champ et le chemin d'accès par défaut.
Delete(String, HttpContext)	Supprime le cookie associé à la demande spécifiée avec le nom spécifié, le champ et le chemin d'accès par défaut.
Delete(String, String, String, HttpContext)	Supprime le cookie associé à la demande spécifiée avec le nom, le champ et le chemin d'accès spécifiés.
DeleteCore(String, String, String, HttpContext)	En cas de substitution dans une classe dérivée, supprime le cookie associé à la demande spécifiée qui a le nom, le domaine et le chemin d'accès spécifiés.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MatchCookiePath(Uri, Uri)	Si le domaine cible est dans le domaine du cookie et si le chemin d'accès cible se trouve dans le chemin d'accès du cookie, respecte la casse de la partie du chemin d'accès du cookie.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Read()	Lit le cookie associé à la demande actuelle avec le nom par défaut.
Read(HttpContext)	Lit le cookie associé à la demande actuelle avec le nom, le domaine et le chemin d'accès par défaut.
Read(String)	Lit le cookie associé à la demande actuelle avec le nom spécifié.
Read(String, HttpContext)	Lit le cookie associé à la demande spécifiée avec le nom spécifié et le domaine et chemin d'accès par défaut.
ReadCore(String, HttpContext)	En cas de substitution dans une classe dérivée, lit le cookie portant le nom spécifié et étant associé à la demande spécifiée.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Write(Byte[], Boolean, DateTime)	Écrit un cookie associé à la demande actuelle portant la valeur, la persistance et le délai d'expiration spécifiés.
Write(Byte[], String, DateTime)	Écrit un cookie associé à la demande actuelle portant le nom, la valeur et le délai d'expiration spécifiés.
Write(Byte[], String, DateTime, HttpContext)	Écrit un cookie associé à la demande spécifiée portant le nom, la valeur et le délai d'expiration spécifiés.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Écrit un cookie associé à la demande spécifiée portant le nom, la valeur, le domaine, le chemin d'accès, le délai d'expiration et la visibilité spécifiés.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	En cas de substitution dans une classe dérivée, écrit un cookie associé à la demande spécifiée portant le nom, la valeur, le domaine, le chemin d'accès, le délai d'expiration, la persistance et la visibilité spécifiés.

S’applique à