WindowsAuthenticationEventArgs Classe

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Fornece dados para o evento WindowsAuthentication_OnAuthenticate. Essa classe não pode ser herdada.

public ref class WindowsAuthenticationEventArgs sealed : EventArgs

public sealed class WindowsAuthenticationEventArgs : EventArgs

type WindowsAuthenticationEventArgs = class
    inherit EventArgs

Public NotInheritable Class WindowsAuthenticationEventArgs
Inherits EventArgs

Herança

Object

EventArgs

WindowsAuthenticationEventArgs

Exemplos

O exemplo de código a seguir usa o evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext como um objeto personalizado IPrincipal .

public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
  if (!args.Identity.IsAnonymous)
  {
    args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
  }
}

Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
  If Not args.Identity.IsAnonymous Then
    args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
  End If
End Sub

Comentários

A WindowsAuthenticationEventArgs classe é usada para fornecer valores de evento para o evento WindowsAuthentication_OnAuthenticate e para permitir que você especifique uma identidade personalizada do Windows para a solicitação atual.

O WindowsAuthenticationModule constrói um WindowsAuthenticationEventArgs objeto usando a identidade do Windows fornecida pelo IIS e o atual HttpContext e o passa para o evento WindowsAuthentication_OnAuthenticate .

Você pode usar a User propriedade do WindowsAuthenticationEventArgs objeto fornecido ao evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext como um objeto personalizado IPrincipal . Se você não especificar um valor para a User propriedade durante o evento WindowsAuthentication_OnAuthenticate , a identidade do Windows fornecida pelo IIS será usada como a identidade da solicitação atual. Se o IIS usar autenticação anônima, a Identity propriedade será definida como a identidade retornada pelo GetAnonymous método .

O evento WindowsAuthentication_OnAuthenticate é gerado somente quando a autenticação Mode é definida Windows como e o WindowsAuthenticationModule é um módulo HTTP ativo para o aplicativo.

Construtores

WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext)

Inicializa uma instância recém-criada da classe WindowsAuthenticationEventArgs.

Propriedades

Context	Obtém o objeto HttpContext para a solicitação HTTP atual.
Identity	Obtém a identidade do Windows passada para o construtor WindowsAuthenticationEventArgs.
User	Obtém ou define o objeto IPrincipal a ser associado à solicitação atual.

Métodos

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)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Provedor de Autenticação do Windows