AnonymousIdentificationModule.ClearAnonymousIdentifier Método

Definição

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Limpa o cookie anônimo ou o identificador associado a uma sessão.

public:
 static void ClearAnonymousIdentifier();
public static void ClearAnonymousIdentifier();
static member ClearAnonymousIdentifier : unit -> unit
Public Shared Sub ClearAnonymousIdentifier ()

Exceções

NotSupportedException

Chamando ClearAnonymousIdentifier() quando a identificação anônima não estiver habilitada.

-ou-

O usuário da solicitação atual é anônimo.

Comentários

O ClearAnonymousIdentifier método remove o identificador anônimo associado a uma sessão em um site. Use o ClearAnonymousIdentifier método para remover o identificador anônimo associado a uma sessão quando o usuário alterna para uma sessão autenticada associada a uma ID de usuário, por exemplo, quando o MigrateAnonymous evento ocorre.

Como um novo identificador anônimo será emitido imediatamente se o identificador anônimo atual for removido, o ClearAnonymousIdentifier método gerará um NotSupportedException se for chamado enquanto a sessão for identificada por um identificador anônimo.

Se o site estiver usando cookies, o ClearAnonymousIdentifier método emitirá um cookie claro para remover o identificador anônimo do navegador. O cookie claro é emitido mesmo se um cookie anônimo não foi enviado na solicitação anterior.

O cookie claro é construído da seguinte maneira:

  • Se o navegador der suporte a cadeias de caracteres vazias em um cookie, o cookie será emitido com a cadeia de caracteres vazia como seu valor; caso contrário, o cookie é emitido com "NoCookie" como seu valor.

  • Os valores do nome, caminho e domínio do cookie são definidos como os padrões configurados no arquivo de configuração do aplicativo Web.

  • A data de validade está definida para 12 de outubro de 1999.

Se o site estiver usando a autenticação sem cookie e um identificador anônimo estiver presente na URL, o identificador anônimo será removido da URL. Nenhuma outra alteração é feita na cadeia de caracteres de endereço ou consulta. Depois que a URL é modificada, um redirecionamento é emitido para retornar à página em execução no momento.

Aplica-se a