AuthenticatingEventArgs.CustomCredential Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft zusätzliche Benutzerwerte für die Authentifizierung ab.
public:
property System::String ^ CustomCredential { System::String ^ get(); };public string CustomCredential { get; }member this.CustomCredential : stringPublic ReadOnly Property CustomCredential As StringEigenschaftswert
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.
