WindowsAuthenticationEventHandler Delegado

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.dll

Representa el método que controla el evento WindowsAuthentication_OnAuthenticate de un 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

Origen del evento.

e

WindowsAuthenticationEventArgs

Objeto WindowsAuthenticationEventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se usa el evento WindowsAuthentication_OnAuthenticate para establecer la User propiedad del objeto actual HttpContext en un 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

Comentarios

El WindowsAuthenticationEventHandler delegado se define para el Authenticate evento de la WindowsAuthenticationModule clase . Puede acceder al Authenticate evento de la WindowsAuthenticationModule clase especificando una subrutina denominada WindowsAuthentication_OnAuthenticate en el archivo Global.asax de la aplicación ASP.NET. El Authenticate evento se genera durante el AuthenticateRequest evento .

WindowsAuthenticationModule Construye un WindowsAuthenticationEventArgs objeto mediante la identidad de Windows proporcionada por IIS y el actual HttpContext y lo pasa al evento WindowsAuthentication_OnAuthenticate.

Puede usar la User propiedad del WindowsAuthenticationEventArgs objeto proporcionado al evento WindowsAuthentication_OnAuthenticate para establecer la User propiedad del objeto actual HttpContext en un objeto personalizado IPrincipal . Si no especifica un valor para la User propiedad durante el evento de WindowsAuthentication_OnAuthenticate , la identidad de Windows proporcionada por IIS se usa como identidad para la solicitud actual. Si IIS usa la autenticación anónima, la Identity propiedad del WindowsAuthenticationEventArgs objeto se establece en la identidad devuelta por el GetAnonymous método .

El evento WindowsAuthentication_OnAuthenticate solo se genera cuando la autenticación Mode se establece Windows en y WindowsAuthenticationModule es un módulo HTTP activo para la aplicación.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.

Consulte también

• Proveedor de autenticación de Windows