WindowsAuthenticationEventHandler Delegar

Definição

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

Representa o método que gere o evento WindowsAuthentication_OnAuthenticate de um WindowsAuthenticationModule.

public delegate void WindowsAuthenticationEventHandler(System::Object ^ sender, WindowsAuthenticationEventArgs ^ e);
public delegate void WindowsAuthenticationEventHandler(object sender, WindowsAuthenticationEventArgs e);
type WindowsAuthenticationEventHandler = delegate of obj * WindowsAuthenticationEventArgs -> unit
Public Delegate Sub WindowsAuthenticationEventHandler(sender As Object, e As WindowsAuthenticationEventArgs)

Parâmetros

sender
Object

A origem do evento.

e
WindowsAuthenticationEventArgs

A WindowsAuthenticationEventArgs que contém os dados do evento.

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

O WindowsAuthenticationEventHandler delegado é definido para o Authenticate evento da WindowsAuthenticationModule turma. Pode aceder ao evento Authenticate da classe WindowsAuthenticationModule especificando uma sub-rotina chamada WindowsAuthentication_OnAuthenticate no ficheiro Global.asax da sua aplicação ASP.NET. O Authenticate evento é levantado durante o AuthenticateRequest evento.

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 do WindowsAuthenticationEventArgs objeto é definida para a identidade devolvida pelo GetAnonymous método.

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

Métodos da Extensão

Name Description
GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.

Aplica-se a

Ver também