AuthenticatingEventArgs.CustomCredential Propriété

Définition

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é

String

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' Authenticating événement qui analyse deux valeurs d’authentification à partir de la CustomCredential propriété. Il transmet les deux valeurs et 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 au cours de l' Authenticating événement. 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.

S’applique à

Voir aussi