CookieHandler Clase

Definición

Espacio de nombres:

System.IdentityModel.Services

Ensamblado:

System.IdentityModel.Services.dll

Proporciona una clase base abstracta para leer, escribir, y eliminar las cookies de sesión en un cliente HTTP.

public ref class CookieHandler abstract

public abstract class CookieHandler

type CookieHandler = class

Public MustInherit Class CookieHandler

Herencia

Object

CookieHandler

Derivado

System.IdentityModel.Services.ChunkedCookieHandler

Ejemplos

En el ejemplo siguiente se configura sam para usar un controlador de cookies personalizado de tipo MyNamespace.MyCustomCookieHandler.

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

Comentarios

( SessionAuthenticationModule SAM) usa una instancia de la CookieHandler clase para leer, escribir y eliminar la cookie o las cookies que contienen en SessionSecurityToken el cliente HTTP. La cookie (o cookies, en el caso de que el token de sesión se divida entre varias cookies) que contiene el token de sesión se conoce como cookie de sesión.

Windows Identity Foundation (WIF) se incluye con un controlador de cookies denominado controlador de cookies fragmentado implementado por la ChunkedCookieHandler clase . El controlador de cookies fragmentado divide el token de sesión en una o varias cookies según un tamaño de fragmento especificado. Esto es para cumplir las limitaciones de tamaño de las cookies individuales impuestas por muchos navegadores.

Puede derivar de CookieHandler para crear su propio controlador de cookies. Al hacerlo, debe invalidar los DeleteCoremétodos , ReadCorey WriteCore para realizar el trabajo real de eliminación, lectura y escritura de la cookie de sesión. Normalmente, estos métodos leen la cookie de la HttpRequest.Cookies colección y escriben o eliminan cookies a través de la HttpResponse.Cookies colección. El HttpContext objeto a través del cual se puede acceder a la solicitud y respuesta se proporciona como parámetro para cada uno de estos métodos. Además de los métodos necesarios, puede invalidar opcionalmente otras propiedades de métodos virtuales expuestas por la CookieHandler clase para personalizar el comportamiento del controlador.

La clase expone CookieHandler varias propiedades que especifican el comportamiento predeterminado y las propiedades de la cookie de sesión. Las Namepropiedades , Domainy Path proporcionan el nombre base de la cookie, el dominio en el que es válido y la ruta de acceso en la que se almacena en el cliente. La HideFromClientScript propiedad especifica si la cookie es accesible para los scripts del lado cliente. La RequireSsl propiedad especifica si la cookie solo se debe transmitir a través de conexiones seguras (HTTPS). Si se establece, la PersistentSessionLifetime propiedad se usa para establecer la hora de expiración de las sesiones persistentes, es decir, para las sesiones que permanecen válidas incluso después de cerrar el explorador. Todas estas propiedades tienen propiedades equivalentes que normalmente se establecen en el objeto subyacente HttpCookie (u objetos) mediante los métodos "core" del controlador. Para obtener más información, consulte la documentación de cada propiedad.

El controlador de cookies que usa el SAM se puede especificar en la configuración a través del <elemento cookieHandler> . El controlador de cookies establecido por este elemento se puede modificar en un delegado de eventos para el FederatedAuthentication.FederationConfigurationCreated evento o se puede establecer o acceder directamente a través de la SessionAuthenticationModule.CookieHandler propiedad .

Constructores

CookieHandler()

Se llama desde constructores de clases derivadas para inicializar la clase CookieHandler.

Propiedades

Domain	Obtiene o establece el dominio usado para las cookies.
HideFromClientScript	Obtiene o establece un valor que indica si la cookie se debe ocultar del script cliente.
Name	Obtiene o establece el nombre base para las cookies escritas por el controlador.
Path	Obtiene o establece el valor de la ruta virtual para las cookies creadas por el controlador.
PersistentSessionLifetime	Duración de sesiones persistentes. Si es cero, siempre se usan sesiones transitorias.
RequireSsl	Obtiene o establece un valor que especifica si la cookie se debe usar solo con SSL.

Métodos

Delete()	Elimina la cookie asociada con la solicitud actual que tiene el nombre, la ruta de acceso y el dominio predeterminados.
Delete(HttpContext)	Elimina la cookie asociada con la solicitud actual que tiene el nombre, la ruta de acceso y el dominio predeterminados.
Delete(String)	Elimina la cookie asociada con la solicitud actual que tiene el nombre especificado, y el dominio y la ruta de acceso predeterminados.
Delete(String, HttpContext)	Elimina la cookie asociada con la solicitud especificada que tiene el nombre especificado, y el dominio y la ruta de acceso predeterminados.
Delete(String, String, String, HttpContext)	Elimina la cookie asociada con la solicitud especificada que tiene el nombre, la ruta de acceso y el dominio especificados.
DeleteCore(String, String, String, HttpContext)	Cuando se reemplaza en una clase derivada, elimina la cookie asociada a la solicitud especificada que tiene el nombre, el dominio y la ruta de acceso especificados.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MatchCookiePath(Uri, Uri)	Si el dominio de destino está dentro del dominio de la cookie y la ruta de acceso de destino está dentro de la ruta de acceso de la cookie, coincide con el uso de mayúsculas y minúsculas de la parte de la ruta de acceso de la cookie.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Read()	Lee la cookie asociada con la solicitud actual que tiene el nombre predeterminado.
Read(HttpContext)	Lee la cookie asociada con la solicitud actual que tiene el nombre, la ruta de acceso y el dominio predeterminados.
Read(String)	Lee la cookie asociada con la solicitud actual que tiene el nombre especificado.
Read(String, HttpContext)	Lee la cookie asociada con la solicitud especificada que tiene el nombre especificado y el dominio y la ruta de acceso predeterminados.
ReadCore(String, HttpContext)	Cuando se reemplaza en una clase derivada, lee la cookie que tiene el nombre especificado y que está asociada a la solicitud especificada.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Write(Byte[], Boolean, DateTime)	Escribe una cookie asociada a la solicitud actual que tiene el valor, la persistencia y la fecha de expiración especificados.
Write(Byte[], String, DateTime)	Escribe una cookie asociada a la solicitud actual que tiene el nombre, el valor y la fecha de expiración especificados.
Write(Byte[], String, DateTime, HttpContext)	Escribe una cookie asociada a la solicitud especificada que tiene el nombre, el valor y la fecha de expiración especificados.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Escribe una cookie asociada a la solicitud especificada que tiene el nombre, el valor, el dominio, la ruta de acceso, la fecha de expiración y la visibilidad especificados.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Cuando se reemplaza en una clase derivada, escribe una cookie asociada a la solicitud especificada que tiene el nombre, el valor, el dominio, la ruta de acceso, la fecha de expiración, la persistencia y la visibilidad especificados.

Consulte también

• ChunkedCookieHandler
• <cookieHandler>