AuthenticatingEventArgs.CustomCredential Propriedade

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

public string CustomCredential { get; }

member this.CustomCredential : string

Public ReadOnly Property CustomCredential As String

Valor de Propriedade

Os valores necessários para autenticação para além do nome de utilizador e palavra-passe.

Exemplos

O exemplo seguinte mostra um gestor de eventos para o Authenticating evento que analisa dois valores de autenticação da CustomCredential propriedade. Passa os dois valores, o nome de utilizador e a palavra-passe 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

Observações

Pode usar a CustomCredential propriedade para recuperar valores de autenticação diferentes do nome de utilizador e palavra-passe durante o Authenticating evento. Por exemplo, uma aplicação pode ser configurada para validar um número de identificação juntamente com o nome de utilizador e a palavra-passe. Nesse caso, o número de identificação será passado no CustomCredential parâmetro do Login método. Pode então obter o valor personalizado através da CustomCredential propriedade.

A CustomCredential propriedade contém os valores personalizados no mesmo formato em que são passados ao Login método. No Authenticating gestor de eventos, se mais do que um valor estiver armazenado na propriedade, deve analisar o valor da CustomCredential propriedade para recuperar esses valores.

Ver também

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