WindowsAuthenticationEventHandler Delegar

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Representa o método que manipula 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 fonte do evento.

e

WindowsAuthenticationEventArgs

Um WindowsAuthenticationEventArgs que contém os dados do evento.

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

O WindowsAuthenticationEventHandler delegado é definido para o Authenticate evento da WindowsAuthenticationModule classe . Você pode acessar o Authenticate evento da WindowsAuthenticationModule classe especificando uma sub-rotina chamada WindowsAuthentication_OnAuthenticate no arquivo Global.asax para seu aplicativo ASP.NET. O Authenticate evento é gerado durante o AuthenticateRequest evento.

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 para o 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 do WindowsAuthenticationEventArgs objeto será definida como a identidade retornada pelo GetAnonymous método .

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

Métodos de Extensão

GetMethodInfo(Delegate)

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

Confira também

• Provedor de Autenticação do Windows