Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
WindowsAuthenticationEventHandler (Delegado)
Representa el método que controla el evento WindowsAuthentication_OnAuthenticate de WindowsAuthenticationModule.
Ensamblado: System.Web (en System.Web.dll)
public delegate void WindowsAuthenticationEventHandler( Object sender, WindowsAuthenticationEventArgs e )
Parámetros
- sender
- Tipo: System.Object
Origen del evento.
- e
- Tipo: System.Web.Security.WindowsAuthenticationEventArgs
Objeto WindowsAuthenticationEventArgs que contiene los datos del evento.
El delegado de WindowsAuthenticationEventHandler se define para el evento Authenticate de la clase WindowsAuthenticationModule. Puede obtener acceso al evento Authenticate de la clase WindowsAuthenticationModule especificando una subrutina denominada WindowsAuthentication_OnAuthenticate en el archivo Global.asax de la aplicación ASP.NET. El evento Authenticate se provoca durante el evento AuthenticateRequest.
El WindowsAuthenticationModule crea un objeto WindowsAuthenticationEventArgs utilizando la identidad de Windows proporcionada por IIS y el HttpContext actual, y lo pasa al evento WindowsAuthentication_OnAuthenticate.
Puede utilizar la propiedad User del objeto WindowsAuthenticationEventArgs que se proporciona al evento WindowsAuthentication_OnAuthenticate para establecer la propiedad User del objeto HttpContext actual en un objeto IPrincipal personalizado. Si no especifica ningún valor para la propiedad User durante el evento WindowsAuthentication_OnAuthenticate, la identidad de Windows proporcionada por IIS se usa como la identidad de la solicitud actual. Si IIS utiliza autenticación anónima, la propiedad Identity del objeto WindowsAuthenticationEventArgs se establece en la identidad devuelta por el método GetAnonymous.
El evento WindowsAuthentication_OnAuthenticate sólo se provoca cuando la propiedad Mode de autenticación se establece en Windows y WindowsAuthenticationModule es un módulo HTTP activo de la aplicación.
En el siguiente ejemplo se utiliza el evento WindowsAuthentication_OnAuthenticate para establecer la propiedad User del HttpContext actual en un objeto IPrincipal personalizado.
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.