AuthenticatingEventArgs.CustomCredential Propriedade

Definição

Namespace:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

Obtém valores de usuário adicionais para autenticação.

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

public string CustomCredential { get; }

member this.CustomCredential : string

Public ReadOnly Property CustomCredential As String

Valor da propriedade

String

Os valores necessários para autenticação que não sejam nome de usuário e senha.

Exemplos

O exemplo a seguir mostra um manipulador de eventos para o Authenticating evento que analisa dois valores de autenticação da CustomCredential propriedade . Ele passa os dois valores e o nome de usuário e a senha para uma classe de autenticação personalizada chamada 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

Comentários

Você pode usar a CustomCredential propriedade para recuperar valores de autenticação diferentes de nome de usuário e senha durante o Authenticating evento. Por exemplo, um aplicativo pode ser configurado para validar um número de identificação junto com o nome de usuário e a senha. Nesse caso, o número de identificação será passado no CustomCredential parâmetro do Login método . Em seguida, você pode recuperar o valor personalizado por meio da CustomCredential propriedade .

A CustomCredential propriedade contém os valores personalizados no mesmo formato que são passados para o Login método . Authenticating No manipulador de eventos, se mais de um valor for armazenado na propriedade , você deverá analisar o valor da CustomCredential propriedade para recuperar os valores.

Confira também

• Visão geral do Serviço de Autenticação do Windows Communication Foundation