WindowsAuthenticationModule Clase

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.dll

Establece la identidad del usuario para una aplicación de ASP.NET cuando está habilitada la autenticación de Windows. Esta clase no puede heredarse.

public ref class WindowsAuthenticationModule sealed : System::Web::IHttpModule

public sealed class WindowsAuthenticationModule : System.Web.IHttpModule

type WindowsAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class WindowsAuthenticationModule
Implements IHttpModule

Herencia

Object

WindowsAuthenticationModule

Implementaciones

IHttpModule

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

Cuando la autenticación Mode se establece Windowsen , WindowsAuthenticationModule establece la User propiedad del objeto actual HttpContext en un IPrincipal objeto que representa la identidad de Windows proporcionada por IIS para la solicitud actual. Si IIS usa la autenticación anónima, usa WindowsAuthenticationModule la identidad devuelta por el GetAnonymous método .

WindowsAuthenticationModule expone un Authenticate evento que permite proporcionar un objeto personalizado IPrincipal para la User propiedad del objeto actualHttpContext. Para Authenticate acceder al evento, especifique una subrutina denominada WindowsAuthentication_OnAuthenticate en el archivo Global.asax para la aplicación de ASP.NET.

Nota:

En IIS 7.0, no se admite el uso de la WindowsAuthenticationModule clase con la FormsAuthenticationModule clase . Para obtener más información sobre los problemas de compatibilidad en modo integrado, consulte Traslado de una aplicación de ASP.NET de IIS 6.0 a IIS 7.0.

Constructores

Nombre	Description
WindowsAuthenticationModule()	Crea una instancia de la clase WindowsAuthenticationModule.

Métodos

Nombre	Description
Dispose()	Libera todos los recursos, distintos de la memoria, usados por .WindowsAuthenticationModule
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Init(HttpApplication)	Inicializa el objeto WindowsAuthenticationModule.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

Nombre	Description
Authenticate	Se produce cuando la aplicación autentica la solicitud actual.

Consulte también

• Proveedor de autenticación de Windows