AuthenticatingEventArgs Klasse

Definition

Namespace:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

Stellt Daten für das Authenticating-Ereignis bereit.

public ref class AuthenticatingEventArgs : EventArgs

public class AuthenticatingEventArgs : EventArgs

type AuthenticatingEventArgs = class
    inherit EventArgs

Public Class AuthenticatingEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

AuthenticatingEventArgs

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler, der die UserName Werte und Password an einen benutzerdefinierten Mitgliedschaftsanbieter übergibt, um die Benutzeranmeldeinformationen zu überprüfen. Der Ereignishandler legt Authenticated den Rückgabewert der ValidateUser Methode fest und legt auf true festAuthenticationIsComplete, damit die AuthenticationService Klasse die Anmeldeinformationen nicht überprüft.

void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
    if (e.UserName.IndexOf("@contoso.com") >= 0)
    {
        e.Authenticated = Membership.Providers["ContosoSqlProvider"].ValidateUser(e.UserName, e.Password);
    }
    else if (e.UserName.IndexOf("@fabrikam.com") >= 0)
    {
        e.Authenticated = Membership.Providers["FabrikamSqlProvider"].ValidateUser(e.UserName, e.Password);
    }
    else
    {
        e.Authenticated = Membership.Provider.ValidateUser(e.UserName, e.Password);
    }
    e.AuthenticationIsComplete = true;
}

Sub AuthenticationService_Authenticating _
   (ByVal sender As Object, _
    ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
    
    If (e.Username.IndexOf("@contoso.com") >= 0) Then
        e.Authenticated = Membership.Providers("ContosoSqlProvider").ValidateUser(e.Username, e.Password)
    ElseIf (e.Username.IndexOf("@fabrikam.com") >= 0) Then
        e.Authenticated = Membership.Providers("FabrikamSqlProvider").ValidateUser(e.Username, e.Password)
    Else
        e.Authenticated = Membership.Provider.ValidateUser(e.Username, e.Password)
    End If
    e.AuthenticationIsComplete = True
End Sub

Hinweise

Sie erstellen einen Handler für das Authenticating Ereignis, wenn Sie die Authentifizierung der Anmeldeinformationen des Benutzers zur Laufzeit anpassen möchten. Die AuthenticatingEventArgs -Klasse stellt Werte für jeden Authenticating Ereignishandler bereit. Mithilfe der in dieser Klasse verfügbaren Eigenschaften können Sie die Benutzeranmeldeinformationen abrufen, um die Authentifizierung anzupassen.

Die AuthenticationService -Klasse löst das Authenticating Ereignis aus, bevor die Benutzeranmeldeinformationen überprüft werden. Die AuthenticationService -Klasse erstellt eine instance des AuthenticatingEventArgs -Objekts und übergibt es an einen beliebigen Authenticating Ereignishandler.

Sie können die UserNameEigenschaften und CustomCredential verwenden, Password um die Benutzeranmeldeinformationen abzurufen. Die CustomCredential Eigenschaft kann zusätzliche Werte enthalten, die für die Authentifizierung erforderlich sind, z. B. eine Identifikationsnummer.

Die Authenticated -Eigenschaft gibt an, ob die Benutzeranmeldeinformationen gültig sind. Sie legen die Authenticated -Eigenschaft auf das Ergebnis Ihrer benutzerdefinierten Authentifizierung fest. Darüber hinaus legen Sie die AuthenticationIsComplete -Eigenschaft auf fest true , wenn Sie die Benutzeranmeldeinformationen überprüft haben und nicht möchten, dass die AuthenticationService Klasse Benutzeranmeldeinformationen über den Standardmitgliedschaftsanbieter überprüft.

Eigenschaften

Authenticated	Ruft einen Wert ab, der angibt, ob die Benutzeranmeldeinformationen gültig sind, oder legt diesen fest.
AuthenticationIsComplete	Ruft einen Wert ab, der angibt, ob die Benutzeranmeldeinformationen authentifiziert wurden, oder legt diesen fest.
CustomCredential	Ruft zusätzliche Benutzerwerte für die Authentifizierung ab.
Password	Ruft das Kennwort für den Benutzer ab.
UserName	Ruft den Authentifizierungsnamen für den Benutzer ab.

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)

Weitere Informationen

• Übersicht über den Windows Communication Foundation-Authentifizierungsdienst