WindowsAuthenticationModule Klasse

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Legt die Identität des Benutzers für eine ASP.NET-Anwendung fest, wenn die Windows-Authentifizierung aktiviert ist. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

WindowsAuthenticationModule

Implementiert

IHttpModule

Beispiele

Im folgenden Codebeispiel wird das WindowsAuthentication_OnAuthenticate-Ereignis verwendet, um die User -Eigenschaft des aktuellen HttpContext auf ein benutzerdefiniertes IPrincipal -Objekt festzulegen.

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

Hinweise

Wenn die Authentifizierung Mode auf Windowsfestgelegt ist, legt die UserWindowsAuthenticationModule -Eigenschaft des aktuellen HttpContext auf ein IPrincipal -Objekt fest, das die von IIS für die aktuelle Anforderung bereitgestellte Windows-Identität darstellt. Wenn IIS anonyme Authentifizierung verwendet, verwendet die WindowsAuthenticationModule von der GetAnonymous -Methode zurückgegebene Identität.

Macht WindowsAuthenticationModule ein Authenticate Ereignis verfügbar, mit dem Sie ein benutzerdefiniertes IPrincipal Objekt für die User -Eigenschaft des aktuellen HttpContextbereitstellen können. Auf Authenticate das Ereignis wird zugegriffen, indem eine Unterroutine mit dem Namen WindowsAuthentication_OnAuthenticate in der Datei Global.asax für Ihre ASP.NET-Anwendung angegeben wird.

Hinweis

In IIS 7.0 wird die Verwendung der WindowsAuthenticationModule -Klasse mit der FormsAuthenticationModule -Klasse nicht unterstützt. Weitere Informationen zu Kompatibilitätsproblemen im integrierten Modus finden Sie unter Verschieben einer ASP.NET-Anwendung von IIS 6.0 zu IIS 7.0.

Konstruktoren

WindowsAuthenticationModule()

Erstellt eine Instanz der WindowsAuthenticationModule-Klasse.

Methoden

Dispose()	Gibt alle Ressourcen mit Ausnahme des Arbeitsspeichers frei, die vom WindowsAuthenticationModule verwendet werden.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Init(HttpApplication)	Initialisiert das WindowsAuthenticationModule-Objekt.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

Authenticate

Tritt ein, wenn die Anwendung die aktuelle Anforderung authentifiziert.

Weitere Informationen

• Windows-Authentifizierungsanbieter