Freigeben über

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 Objekts 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 Windows festgelegt ist, wird die WindowsAuthenticationModuleUser Eigenschaft des aktuellen HttpContext Objekts auf ein IPrincipal Objekt festgelegt, 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.

Das WindowsAuthenticationModule Verfügbarmachen eines Authenticate Ereignisses, mit dem Sie ein benutzerdefiniertes IPrincipal Objekt für die User Eigenschaft des aktuellen HttpContextObjekts bereitstellen können. Auf das Authenticate Ereignis wird zugegriffen, indem eine Unterroutine namens 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 auf IIS 7.0.

Konstruktoren

Name Beschreibung
WindowsAuthenticationModule()

Erstellt eine Instanz der WindowsAuthenticationModule-Klasse.

Methoden

Name Beschreibung
Dispose()

Gibt alle Ressourcen außer Arbeitsspeicher frei, die von der WindowsAuthenticationModule.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
Init(HttpApplication)

Initialisiert das WindowsAuthenticationModule-Objekt.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Ereignisse

Name Beschreibung
Authenticate

Tritt auf, wenn die Anwendung die aktuelle Anforderung authentifiziert.

Gilt für:

Weitere Informationen