AuthenticatingEventArgs Clase
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í.
Proporciona datos para el evento Authenticating.
public ref class AuthenticatingEventArgs : EventArgs
public class AuthenticatingEventArgs : EventArgs
type AuthenticatingEventArgs = class
inherit EventArgs
Public Class AuthenticatingEventArgs
Inherits EventArgs
- Herencia
Ejemplos
En el ejemplo siguiente se muestra un controlador de eventos que pasa los UserName valores y Password a un proveedor de pertenencia personalizado para validar las credenciales de usuario. El controlador de eventos establece Authenticated en el valor devuelto del ValidateUser método y establece en AuthenticationIsCompletetrue
para que la AuthenticationService clase no valide las credenciales.
void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
if (e.UserName.IndexOf("@contoso.com") >= 0)
{
e.Authenticated = Membership.Providers["ContosoSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else if (e.UserName.IndexOf("@fabrikam.com") >= 0)
{
e.Authenticated = Membership.Providers["FabrikamSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else
{
e.Authenticated = Membership.Provider.ValidateUser(e.UserName, e.Password);
}
e.AuthenticationIsComplete = true;
}
Sub AuthenticationService_Authenticating _
(ByVal sender As Object, _
ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
If (e.Username.IndexOf("@contoso.com") >= 0) Then
e.Authenticated = Membership.Providers("ContosoSqlProvider").ValidateUser(e.Username, e.Password)
ElseIf (e.Username.IndexOf("@fabrikam.com") >= 0) Then
e.Authenticated = Membership.Providers("FabrikamSqlProvider").ValidateUser(e.Username, e.Password)
Else
e.Authenticated = Membership.Provider.ValidateUser(e.Username, e.Password)
End If
e.AuthenticationIsComplete = True
End Sub
Comentarios
Crea un controlador para el Authenticating evento cuando desea personalizar cómo se autentican las credenciales del usuario en tiempo de ejecución. La AuthenticatingEventArgs clase proporciona valores a cualquier Authenticating controlador de eventos. Con las propiedades disponibles en esta clase, puede recuperar las credenciales de usuario para personalizar la autenticación.
La AuthenticationService clase genera el Authenticating evento antes de validar las credenciales de usuario. La AuthenticationService clase construye una instancia del AuthenticatingEventArgs objeto y la pasa a cualquier Authenticating controlador de eventos.
Puede usar las UserNamepropiedades , Password y CustomCredential para recuperar las credenciales de usuario. La CustomCredential propiedad puede contener valores adicionales necesarios para la autenticación, como un número de identificación.
La Authenticated propiedad indica si las credenciales de usuario son válidas. La propiedad se establece Authenticated en el resultado de la autenticación personalizada. Además, establece la AuthenticationIsComplete propiedad true
en si ha comprobado las credenciales de usuario y no desea que la clase compruebe las AuthenticationService credenciales de usuario a través del proveedor de pertenencia predeterminado.
Propiedades
Authenticated |
Obtiene o establece un valor que indica si las credenciales del usuario son válidas. |
AuthenticationIsComplete |
Obtiene o establece un valor que indica si se han autenticado las credenciales del usuario. |
CustomCredential |
Obtiene valores de usuario adicionales para la autenticación. |
Password |
Obtiene la contraseña del usuario. |
UserName |
Obtiene el nombre de autenticación para el usuario. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |