WindowsAuthenticationEventArgs Klasse

Definition

Stellt Daten für das Ereignis WindowsAuthentication_OnAuthenticate bereits.Provides data for the WindowsAuthentication_OnAuthenticate event. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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

Beispiele

Im folgenden Codebeispiel wird das WindowsAuthentication_OnAuthenticate -Ereignis verwendet, User um die-Eigenschaft HttpContext des aktuellen auf IPrincipal ein benutzerdefiniertes-Objekt festzulegen.The following code example uses the WindowsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a custom IPrincipal object.

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

Mit WindowsAuthenticationEventArgs der-Klasse werden Ereignis Werte für das WindowsAuthentication_OnAuthenticate -Ereignis bereitgestellt, und Sie können eine benutzerdefinierte Windows-Identität für die aktuelle Anforderung angeben.The WindowsAuthenticationEventArgs class is used to supply event values to the WindowsAuthentication_OnAuthenticate event and to enable you to specify a custom Windows identity for the current request.

Erstellt ein WindowsAuthenticationEventArgs -Objekt unter Verwendung der von IIS bereitgestellten Windows-Identität HttpContext und des aktuellen und übergibt es an das WindowsAuthentication_OnAuthenticate-Ereignis. **** WindowsAuthenticationModuleThe WindowsAuthenticationModule constructs a WindowsAuthenticationEventArgs object using the Windows identity supplied by IIS and the current HttpContext and passes it to the WindowsAuthentication_OnAuthenticate event.

Mit der User -Eigenschaft User WindowsAuthenticationEventArgs des-Objekts, das für das WindowsAuthentication_OnAuthenticate -Ereignis bereitgestellt wird, können Sie HttpContext die-Eigenschaft IPrincipal des aktuellen auf ein benutzerdefiniertes-Objekt festlegen.You can use the User property of the WindowsAuthenticationEventArgs object supplied to the WindowsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a custom IPrincipal object. Wenn Sie während des WindowsAuthentication_OnAuthenticate -Ereignisses keinen Wert User für die-Eigenschaft angeben, wird die von IIS bereitgestellte Windows-Identität als Identität für die aktuelle Anforderung verwendet.If you do not specify a value for the User property during the WindowsAuthentication_OnAuthenticate event, the Windows identity supplied by IIS is used as the identity for the current request. Wenn IIS die anonyme Authentifizierung verwendet, wird Identity die-Eigenschaft auf die Identität festgelegt, GetAnonymous die von der-Methode zurückgegeben wird.If IIS uses anonymous authentication, then the Identity property is set to the identity returned by the GetAnonymous method.

Das WindowsAuthentication_OnAuthenticate -Ereignis wird nur ausgelöst, wenn Mode die-Authentifizierung Windows auf fest WindowsAuthenticationModule gelegt ist und das ein aktives HTTP-Modul für die Anwendung ist.The WindowsAuthentication_OnAuthenticate event is raised only when the authentication Mode is set to Windows and the WindowsAuthenticationModule is an active HTTP module for the application.

Konstruktoren

WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext)

Initialisiert eine neu erstellte Instanz der WindowsAuthenticationEventArgs-Klasse.Initializes a newly created instance of the WindowsAuthenticationEventArgs class.

Eigenschaften

Context

Ruft das HttpContext-Objekt für die aktuelle HTTP-Anforderung ab.Gets the HttpContext object for the current HTTP request.

Identity

Ruft die an den WindowsAuthenticationEventArgs-Konstruktor übergebene Windows-Identität ab.Gets the Windows identity passed to the WindowsAuthenticationEventArgs constructor.

User

Ruft das IPrincipal-Objekt ab, das der aktuellen Anforderung zugeordnet werden soll, oder legt dieses fest.Gets or sets the IPrincipal object to be associated with the current request.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch