AuthenticatingEventArgs.CustomCredential Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient des valeurs d'utilisateur supplémentaires pour l'authentification.
public:
property System::String ^ CustomCredential { System::String ^ get(); };
public string CustomCredential { get; }
member this.CustomCredential : string
Public ReadOnly Property CustomCredential As String
Valeur de propriété
Les valeurs requises pour l'authentification, autre que le nom d'utilisateur et le mot de passe.
Exemples
L’exemple suivant montre un gestionnaire d’événements pour l’événement Authenticating qui analyse deux valeurs d’authentification à partir de la CustomCredential propriété . Il transmet les deux valeurs ainsi que le nom d’utilisateur et le mot de passe à une classe d’authentification personnalisée nommée 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
Remarques
Vous pouvez utiliser la CustomCredential propriété pour récupérer des valeurs d’authentification autres que le nom d’utilisateur et le mot de passe pendant l’événement Authenticating . Par exemple, une application peut être configurée pour valider un numéro d’identification avec le nom d’utilisateur et le mot de passe. Dans ce cas, le numéro d’identification est passé dans le CustomCredential
paramètre de la Login méthode. Vous pouvez ensuite récupérer la valeur personnalisée via la CustomCredential propriété .
La CustomCredential propriété contient les valeurs personnalisées dans le même format qu’elles sont passées à la Login méthode. Dans le Authenticating gestionnaire d’événements, si plusieurs valeurs sont stockées dans la propriété, vous devez analyser la valeur de la CustomCredential propriété pour récupérer les valeurs.