WindowsAuthenticationModule Classe

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.dll

Imposta l'identità dell'utente per un'applicazione ASP.NET quando viene attivata l'autenticazione di Windows. La classe non può essere ereditata.

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

Ereditarietà

Object

WindowsAuthenticationModule

Implementazioni

IHttpModule

Esempio

Nell'esempio di codice seguente viene utilizzato l'evento WindowsAuthentication_OnAuthenticate per impostare la User proprietà dell'oggetto corrente HttpContext su un oggetto personalizzato 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

Commenti

Quando l'autenticazione Mode è impostata su Windows, imposta WindowsAuthenticationModule la User proprietà dell'oggetto corrente HttpContext su un IPrincipal oggetto che rappresenta l'identità di Windows fornita da IIS per la richiesta corrente. Se IIS utilizza l'autenticazione anonima, WindowsAuthenticationModule usa l'identità restituita dal GetAnonymous metodo .

WindowsAuthenticationModule espone un Authenticate evento che consente di fornire un oggetto personalizzato IPrincipal per la User proprietà dell'oggetto correnteHttpContext. L'evento Authenticate è accessibile specificando una subroutine denominata WindowsAuthentication_OnAuthenticate nel file Global.asax per l'applicazione ASP.NET.

Nota

In IIS 7.0 l'uso della WindowsAuthenticationModule classe con la FormsAuthenticationModule classe non è supportato. Per altre informazioni sui problemi di compatibilità in modalità integrata, vedere Spostamento di un'applicazione ASP.NET da IIS 6.0 a IIS 7.0.

Costruttori

WindowsAuthenticationModule()

Crea un'istanza della classe WindowsAuthenticationModule.

Metodi

Dispose()	Rilascia tutte le risorse, diverse dalla memoria, utilizzate da WindowsAuthenticationModule.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init(HttpApplication)	Inizializza l'oggetto WindowsAuthenticationModule.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

Authenticate

Si verifica quando la richiesta corrente viene autenticata dall'applicazione.

Vedi anche

• Provider di autenticazione di Windows