CookieHandler Classe

Definição

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Fornece uma classe base abstrata para ler, gravar e excluir cookies de sessão em um cliente HTTP.

public ref class CookieHandler abstract

public abstract class CookieHandler

type CookieHandler = class

Public MustInherit Class CookieHandler

Herança

Object

CookieHandler

Derivado

System.IdentityModel.Services.ChunkedCookieHandler

Exemplos

O exemplo a seguir configura o SAM para usar um manipulador de cookie personalizado do tipo MyNamespace.MyCustomCookieHandler.

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

Comentários

O SessionAuthenticationModule (SAM) usa uma instância da CookieHandler classe para ler, gravar e excluir o cookie ou cookies que contêm o SessionSecurityToken no cliente HTTP. O cookie (ou cookies, no caso em que o token de sessão é dividido entre vários cookies) que contém o token de sessão é conhecido como o cookie de sessão.

O WIF (Windows Identity Foundation) é fornecido com um manipulador de cookie chamado manipulador de cookie em partes implementado pela ChunkedCookieHandler classe . O manipulador de cookie em partes divide o token de sessão em um ou mais cookies de acordo com um tamanho de parte especificado. Isso é para atender às limitações de tamanho em cookies individuais impostos por muitos navegadores.

Você pode derivar de para criar seu próprio manipulador de CookieHandler cookie. Ao fazer isso, você deve substituir os DeleteCoremétodos , ReadCoree WriteCore para executar o trabalho real de exclusão, leitura e gravação do cookie de sessão. Esses métodos normalmente leem o cookie da HttpRequest.Cookies coleção e gravam ou excluem cookies por meio da HttpResponse.Cookies coleção. O HttpContext objeto por meio do qual você pode acessar a solicitação e a resposta é fornecido como um parâmetro para cada um desses métodos. Além dos métodos necessários, opcionalmente, você pode substituir outras propriedades de métodos virtuais expostas pela CookieHandler classe para personalizar o comportamento do manipulador.

Várias propriedades são expostas pela classe que especificam o CookieHandler comportamento padrão e as propriedades do cookie de sessão. As Namepropriedades , Domaine Path fornecem o nome base para o cookie, o domínio no qual ele é válido e o caminho no qual ele é armazenado no cliente. A HideFromClientScript propriedade especifica se o cookie está acessível para scripts do lado do cliente. A RequireSsl propriedade especifica se o cookie deve ser transmitido apenas por conexões HTTPS (seguras). Se definida, a PersistentSessionLifetime propriedade será usada para definir o tempo de expiração para sessões persistentes, ou seja, para sessões que permanecem válidas mesmo após o navegador ser fechado. Todas essas propriedades têm propriedades equivalentes que normalmente são definidas no objeto subjacente HttpCookie (ou objetos) pelos métodos "core" do manipulador. Para obter mais informações, consulte a documentação de cada propriedade.

O manipulador de cookie usado pelo SAM pode ser especificado na configuração por meio do <elemento cookieHandler> . O manipulador de cookie definido por esse elemento pode ser modificado em um delegado de eventos para o FederatedAuthentication.FederationConfigurationCreated evento ou pode ser definido ou acessado diretamente por meio da SessionAuthenticationModule.CookieHandler propriedade .

Construtores

CookieHandler()

Chamado de construtores em classes derivadas para inicializar a classe CookieHandler.

Propriedades

Domain	Obtém ou define o domínio usado para cookies.
HideFromClientScript	Obtém ou define um valor que indica se o cookie deve ser oculto do script de cliente.
Name	Obtém ou define o nome base dos cookies gravados pelo manipulador.
Path	Obtém ou define o caminho virtual para o cookie gravado pelo manipulador.
PersistentSessionLifetime	O tempo de vida das sessões persistentes. Se for zero, sessões transitórias serão sempre usadas.
RequireSsl	Obtém ou define um valor que especifica se o cookie deve ser usado somente com SSL.

Métodos

Delete()	Exclui o cookie associado à solicitação atual que tem o nome, domínio e caminho padrão.
Delete(HttpContext)	Exclui o cookie associado à solicitação atual que tem o nome, domínio e caminho padrão.
Delete(String)	Exclui o cookie associado à solicitação atual que tem o nome e o domínio padrão e caminho especificados.
Delete(String, HttpContext)	Exclui o cookie associado à solicitação especificada que tem o nome e o domínio padrão e caminho especificados.
Delete(String, String, String, HttpContext)	Exclui o cookie associado à solicitação especificada que tem o nome, caminho e domínio especificados.
DeleteCore(String, String, String, HttpContext)	Quando substituído em uma classe derivada, exclui o cookie associado à solicitação especificada que tem o nome, domínio e caminho especificados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MatchCookiePath(Uri, Uri)	Se o domínio de destino estiver dentro do domínio do cookie e o caminho de destino estiver dentro do caminho do cookie, corresponderá o uso de maiúsculas da parte do caminho do cookie.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Read()	Lê o cookie associado à solicitação atual que tem o nome padrão.
Read(HttpContext)	Lê o cookie associado à solicitação atual que tem o nome, domínio e caminho padrão.
Read(String)	Lê o cookie associado à solicitação atual que tem o nome especificado.
Read(String, HttpContext)	Lê o cookie associado à solicitação especificada que tem o nome e o domínio padrão e caminho especificados.
ReadCore(String, HttpContext)	Quando substituído em uma classe derivada, lê o cookie que tem o nome especificado e que está associado com a solicitação especificada.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Write(Byte[], Boolean, DateTime)	Grava um cookie associado à solicitação atual que tem o valor, a persistência e a hora de expiração especificados.
Write(Byte[], String, DateTime)	Grava um cookie associado à solicitação atual que tem o nome, o valor e a hora de expiração especificados.
Write(Byte[], String, DateTime, HttpContext)	Grava um cookie associado à solicitação especificada que tem o nome, o valor e a hora de expiração especificados.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Grava um cookie associado à solicitação especificada que tem o nome, o valor, o domínio, o caminho, a hora de expiração e a visibilidade especificados.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Quando substituído em uma classe derivada, grava um cookie associado à solicitação especificada que tem o nome, valor, domínio, caminho, tempo de expiração, persistência e visibilidade especificados.

Confira também

• ChunkedCookieHandler
• <cookieHandler>