Partilhar via

CookieHandler Classe

Definição

Namespace:
System.IdentityModel.Services
Assembly:
System.IdentityModel.Services.dll

Fornece uma classe base abstrata para ler, escrever 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

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 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 WINDOWS Identity Foundation (WIF) é fornecido com um manipulador de cookie chamado manipulador de cookie em partes que é 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 para criar seu próprio manipulador de CookieHandler cookie. Ao fazer isso, você deve substituir o DeleteCore, ReadCoree WriteCore os métodos 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 sob o qual ele é armazenado no cliente. A HideFromClientScript propriedade especifica se o cookie está acessível a 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

Nome Description
CookieHandler()

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

Propriedades

Nome Description
Domain

Obtém ou define o domínio usado para cookies.
HideFromClientScript

Obtém ou define um valor que indica se o cookie deve estar oculto do script do cliente.
Name

Obtém ou define o nome base para cookies gravados pelo manipulador.
Path

Obtém ou define o caminho virtual para cookies gravados pelo manipulador.
PersistentSessionLifetime

O tempo de vida das sessões persistentes. Se zero, sessões transitórias são sempre usadas.
RequireSsl

Obtém ou define um valor que especifica se o cookie deve ser usado apenas com SSL.

Métodos

Nome Description
Delete()

Exclui o cookie associado à solicitação atual que tem o nome, o domínio e o caminho padrão.
Delete(HttpContext)

Exclui o cookie associado à solicitação atual que tem o nome, o domínio e o caminho padrão.
Delete(String, HttpContext)

Exclui o cookie associado à solicitação especificada que tem o nome especificado e o domínio e o caminho padrão.
Delete(String, String, String, HttpContext)

Exclui o cookie associado à solicitação especificada que tem o nome, o caminho e o domínio especificados.
Delete(String)

Exclui o cookie associado à solicitação atual que tem o nome especificado e o domínio e o caminho padrão.
DeleteCore(String, String, String, HttpContext)

Quando substituído em uma classe derivada, exclui o cookie associado à solicitação especificada que tem o nome, o domínio e o 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 de cookie e o caminho de destino estiver dentro do caminho do cookie, corresponda à caixa da parte do caminho do cookie.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(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, o domínio e o caminho padrão.
Read(String, HttpContext)

Lê o cookie associado à solicitação especificada que tem o nome especificado e o domínio e o caminho padrão.
Read(String)

Lê o cookie associado à solicitação atual que tem o nome especificado.
ReadCore(String, HttpContext)

Quando substituído em uma classe derivada, lê o cookie que tem o nome especificado e que está associado à 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 o tempo 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, DateTime)

Grava um cookie associado à solicitação atual 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, o tempo 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, o valor, o domínio, o caminho, o tempo de expiração, a persistência e a visibilidade especificados.

Aplica-se a

Confira também