WindowsAuthenticationEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Daten für das Ereignis WindowsAuthentication_OnAuthenticate bereits. Diese Klasse kann nicht vererbt werden.
public ref class WindowsAuthenticationEventArgs sealed : EventArgspublic sealed class WindowsAuthenticationEventArgs : EventArgstype WindowsAuthenticationEventArgs = class
inherit EventArgsPublic NotInheritable Class WindowsAuthenticationEventArgs
Inherits EventArgs- Vererbung
Beispiele
Im folgenden Codebeispiel wird das WindowsAuthentication_OnAuthenticate-Ereignis verwendet, um die User Eigenschaft des current 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
Die WindowsAuthenticationEventArgs -Klasse wird zum Bereitstellen von Ereigniswerten für das WindowsAuthentication_OnAuthenticate-Ereignis und zum Angeben einer benutzerdefinierten Windows-Identität für die aktuelle Anforderung verwendet.
Der WindowsAuthenticationModule erstellt ein WindowsAuthenticationEventArgs Objekt unter Verwendung der von IIS bereitgestellten Windows-Identität und der aktuellen HttpContext und übergibt es an das WindowsAuthentication_OnAuthenticate-Ereignis .
Sie können die User -Eigenschaft des -Objekts verwenden, das WindowsAuthenticationEventArgs für das WindowsAuthentication_OnAuthenticate-Ereignis bereitgestellt wird, um die User Eigenschaft des current HttpContext 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 die 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 Windows festgelegt ist, und das WindowsAuthenticationModule ist ein aktives HTTP-Modul für die Anwendung.
Konstruktoren
| WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext) |
Initialisiert eine neu erstellte Instanz der WindowsAuthenticationEventArgs-Klasse. |
Eigenschaften
| 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 |
Ruft das IPrincipal-Objekt ab, das der aktuellen Anforderung zugeordnet werden soll, oder legt dieses fest. |
Methoden
| 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) |
| 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) |
