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 Ereignis, das Authenticating zwei Authentifizierungswerte aus der CustomCredential -Eigenschaft analysiert. Sie übergibt die beiden Werte sowie den Benutzernamen und das Kennwort an eine benutzerdefinierte Authentifizierungsklasse namens 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 während des Authenticating Ereignisses andere Authentifizierungswerte als Benutzername und Kennwort 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 benutzerdefinierten Werte im gleichen Format, wie sie an die Login -Methode übergeben werden. Wenn im Authenticating Ereignishandler mehrere Werte in der -Eigenschaft gespeichert sind, müssen Sie den Wert der CustomCredential -Eigenschaft analysieren, um die Werte abzurufen.

Weitere Informationen

• Übersicht über den Windows Communication Foundation-Authentifizierungsdienst