WindowsAuthenticationEventArgs Classe

Definição

Espaço de Nomes:
System.Web.Security
Assemblagem:
System.Web.dll

Fornece dados para o evento WindowsAuthentication_OnAuthenticate . Esta 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 seguinte utiliza o evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext para 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

Observações

A classe WindowsAuthenticationEventArgs é usada para fornecer valores de evento ao evento WindowsAuthentication_OnAuthenticate e para permitir especificar uma identidade de Windows personalizada para o pedido atual.

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

Pode usar a User propriedade do WindowsAuthenticationEventArgs objeto fornecida ao evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext para um objeto personalizado IPrincipal . Se não especificar um valor para a propriedade User durante o evento WindowsAuthentication_OnAuthenticate, a identidade Windows fornecida pelo IIS é usada como identidade para o pedido atual. Se o IIS usar autenticação anónima, então a Identity propriedade é definida para a identidade devolvida pelo GetAnonymous método.

O evento WindowsAuthentication_OnAuthenticate é ativado apenas quando a autenticação Mode está definida para Windows e a WindowsAuthenticationModule é um módulo HTTP ativo para a aplicação.

Construtores

Name Description
WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext)

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

Propriedades

Name Description
Context

Obtém o HttpContext objeto para o pedido HTTP atual.
Identity

Passa a identidade Windows para o construtor WindowsAuthenticationEventArgs.
User

Obtém ou define o IPrincipal objeto para ser associado ao pedido atual.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também