AuthenticatingEventArgs.CustomCredential Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene valores de usuario adicionales para la autenticación.
public:
property System::String ^ CustomCredential { System::String ^ get(); };
public string CustomCredential { get; }
member this.CustomCredential : string
Public ReadOnly Property CustomCredential As String
Valor de propiedad
Valores requeridos para la autenticación que no son el nombre de usuario y la contraseña.
Ejemplos
En el ejemplo siguiente se muestra un controlador de eventos para el Authenticating evento que analiza dos valores de autenticación de la CustomCredential propiedad . Pasa los dos valores y el nombre de usuario y la contraseña a una clase de autenticación personalizada denominada 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
Comentarios
Puede usar la CustomCredential propiedad para recuperar valores de autenticación distintos del nombre de usuario y la contraseña durante el Authenticating evento. Por ejemplo, una aplicación podría configurarse para validar un número de identificación junto con el nombre de usuario y la contraseña. En ese caso, el número de identificación se pasará en el CustomCredential
parámetro del Login método . A continuación, puede recuperar el valor personalizado a través de la CustomCredential propiedad .
La CustomCredential propiedad contiene los valores personalizados en el mismo formato que se pasan al Login método . En el Authenticating controlador de eventos, si hay más de un valor almacenado en la propiedad , debe analizar el valor de la CustomCredential propiedad para recuperar los valores.