Freigeben über


AuthenticatingEventArgs Klasse

Definition

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
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 Instanz des AuthenticatingEventArgs -Objekts und übergibt sie 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)

Gilt für:

Weitere Informationen