Freigeben über

WindowsAuthenticationEventArgs Klasse

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Stellt Daten für das WindowsAuthentication_OnAuthenticate-Ereignis bereit . Diese Klasse kann nicht vererbt werden.

public ref class WindowsAuthenticationEventArgs sealed : EventArgs
public sealed class WindowsAuthenticationEventArgs : EventArgs
type WindowsAuthenticationEventArgs = class
    inherit EventArgs
Public NotInheritable Class WindowsAuthenticationEventArgs
Inherits EventArgs
Vererbung
Object
EventArgs
WindowsAuthenticationEventArgs

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

Die WindowsAuthenticationEventArgs Klasse wird verwendet, um Ereigniswerte für das WindowsAuthentication_OnAuthenticate-Ereignis bereitzustellen und Ihnen die Angabe einer benutzerdefinierten Windows-Identität für die aktuelle Anforderung zu ermöglichen.

Das WindowsAuthenticationModule Erstellt ein WindowsAuthenticationEventArgs Objekt mit der von IIS bereitgestellten Windows-Identität und dem aktuellen HttpContext Objekt und übergibt es an das WindowsAuthentication_OnAuthenticate-Ereignis .

Sie können die User Eigenschaft des Objekts verwenden, das WindowsAuthenticationEventArgs dem WindowsAuthentication_OnAuthenticate-Ereignis bereitgestellt wird, um die User Eigenschaft des aktuellen HttpContext Objekts auf ein benutzerdefiniertes IPrincipal Objekt festzulegen. Wenn Sie während des WindowsAuthentication_OnAuthenticate-Ereignisses keinen Wert für die User Eigenschaft angeben, wird die von IIS bereitgestellte Windows-Identität als Identität für die aktuelle Anforderung verwendet. Wenn IIS anonyme Authentifizierung verwendet, wird die Identity Eigenschaft auf die von der GetAnonymous Methode zurückgegebene Identität festgelegt.

Das WindowsAuthentication_OnAuthenticate-Ereignis wird nur ausgelöst, wenn die Authentifizierung Mode auf ein WindowsAuthenticationModule aktives HTTP-Modul für die Anwendung festgelegt Windows ist.

Konstruktoren

Name Beschreibung
WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext)

Initialisiert eine neu erstellte Instanz der WindowsAuthenticationEventArgs Klasse.

Eigenschaften

Name Beschreibung
Context

Ruft das HttpContext Objekt für die aktuelle HTTP-Anforderung ab.
Identity

Ruft die An den WindowsAuthenticationEventArgs Konstruktor übergebene Windows-Identität ab.
User

Dient zum Abrufen oder Festlegen des IPrincipal Objekts, das der aktuellen Anforderung zugeordnet werden soll.

Methoden

Name Beschreibung
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)
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)

Gilt für:

Weitere Informationen