AuthenticatingEventArgs.CustomCredential Eigenschaft

Definition

Namespace:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

Ruft zusätzliche Benutzerwerte für die Authentifizierung ab.

public:
 property System::String ^ CustomCredential { System::String ^ get(); };

public string CustomCredential { get; }

member this.CustomCredential : string

Public ReadOnly Property CustomCredential As String

Eigenschaftswert

String

Die für die Authentifizierung erforderlichen Werte, außer Benutzername und Kennwort.

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler für das Authenticating Ereignis, das zwei Authentifizierungswerte aus der CustomCredential -Eigenschaft analysiert. Sie übergibt die beiden Werte sowie den Benutzernamen und das Kennwort an eine benutzerdefinierte Authentifizierungsklasse mit dem Namen StudentAuthentication.

void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
    string studentid = String.Empty;
    string answer = String.Empty;

    string[] credentials =
        e.CustomCredential.Split(new char[] { ',' });
    if (credentials.Length > 0)
    {
        studentid = credentials[0];
        if (credentials.Length > 1)
        {
            answer = credentials[1];
        }
    }

    try
    {
        e.Authenticated =
            StudentAuthentication.ValidateStudentCredentials
            (e.UserName, e.Password, studentid, answer);
    }
    catch (ArgumentNullException ex)
    {
        e.Authenticated = false;
    }

    e.AuthenticationIsComplete = true;
}

Sub AuthenticationService_Authenticating _
   (ByVal sender As Object, _
    ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
    Dim studentid As String = String.Empty
    Dim answer As String = String.Empty

    Dim credentials As String() = _
         e.CustomCredential.Split(New Char() {","c})
    If (credentials.Length > 0) Then
        studentid = credentials(0)
        If (credentials.Length > 1) Then
            answer = credentials(1)
        End If
    End If

    Try
        e.Authenticated = _
            StudentAuthentication.ValidateStudentCredentials _
            (e.Username, e.Password, studentid, answer)
    Catch ex As ArgumentNullException
        e.Authenticated = False
    End Try
    

    e.AuthenticationIsComplete = True
End Sub

Hinweise

Sie können die CustomCredential -Eigenschaft verwenden, um andere Authentifizierungswerte als Benutzername und Kennwort während des Ereignisses Authenticating abzurufen. Beispielsweise kann eine Anwendung so konfiguriert werden, dass eine Identifikationsnummer zusammen mit dem Benutzernamen und dem Kennwort überprüft wird. In diesem Fall wird die Identifikationsnummer im CustomCredential Parameter der Login -Methode übergeben. Anschließend können Sie den benutzerdefinierten Wert über die CustomCredential -Eigenschaft abrufen.

Die CustomCredential -Eigenschaft enthält die angepassten Werte im gleichen Format, wie sie an die Login -Methode übergeben werden. Wenn im Authenticating Ereignishandler mehr als ein Wert in der -Eigenschaft gespeichert ist, müssen Sie den Wert der CustomCredential -Eigenschaft analysieren, um die Werte abzurufen.

Weitere Informationen

• Übersicht über den Windows Communication Foundation-Authentifizierungsdienst