ClientFormsAuthenticationMembershipProvider 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í.
Habilita la autenticación de formularios con servicios de la aplicación cliente.
public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider
public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider
type ClientFormsAuthenticationMembershipProvider = class
inherit MembershipProvider
Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider
- Herencia
Ejemplos
En el código de ejemplo siguiente se muestra cómo usar este método para validar al usuario mediante una IClientFormsAuthenticationCredentialsProvider implementación.
private bool ValidateUsingCredentialsProvider()
{
bool isAuthorized = false;
try
{
ClientFormsAuthenticationMembershipProvider authProvider =
System.Web.Security.Membership.Provider as
ClientFormsAuthenticationMembershipProvider;
// Call ValidateUser with empty strings in order to display the
// login dialog box configured as a credentials provider.
isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
}
catch (System.Net.WebException)
{
MessageBox.Show("Unable to access the authentication service.",
"Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
}
if (!isAuthorized)
{
MessageBox.Show("Unable to authenticate.", "Not logged in",
MessageBoxButtons.OK, MessageBoxIcon.Error);
Application.Exit();
}
return isAuthorized;
}
Private Function ValidateUsingCredentialsProvider() As Boolean
Dim isAuthorized As Boolean = False
Try
Dim authProvider As ClientFormsAuthenticationMembershipProvider = _
CType(System.Web.Security.Membership.Provider, _
ClientFormsAuthenticationMembershipProvider)
' Call ValidateUser with empty strings in order to display the
' login dialog box configured as a credentials provider.
isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty)
Catch ex As System.Net.WebException
MessageBox.Show("Unable to access the authentication service.", _
"Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)
End Try
If Not isAuthorized Then
MessageBox.Show("Unable to authenticate.", "Not logged in", _
MessageBoxButtons.OK, MessageBoxIcon.Error)
Application.Exit()
End If
Return isAuthorized
End Function
Comentarios
Puede usar los servicios de aplicación cliente para validar a los usuarios mediante la autenticación de formularios. Para habilitar la autenticación de formularios, configure la aplicación para que use la ClientFormsAuthenticationMembershipProvider clase .
Después de la configuración, puede validar a los usuarios llamando al static
Membership.ValidateUser método , que llama internamente al ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) método .
La autenticación de formularios requiere que el usuario especifique sus credenciales a través de los controles de inicio de sesión proporcionados por la aplicación. Puede recuperar las credenciales y pasarlas al Membership.ValidateUser método . También puede pasar cadenas vacías o null
usar un proveedor de credenciales. Un proveedor de credenciales es una IClientFormsAuthenticationCredentialsProvider implementación especificada en el archivo de configuración de la aplicación. Normalmente, implementará el IClientFormsAuthenticationCredentialsProvider.GetCredentials método para mostrar un cuadro de diálogo de inicio de sesión y devolver un objeto rellenado ClientFormsAuthenticationCredentials . El uso de un proveedor de credenciales permite compartir un único cuadro de diálogo de inicio de sesión entre varias aplicaciones.
El ClientFormsAuthenticationMembershipProvider.ValidateUser método autentica a los usuarios a través del servicio de inicio de sesión indicado por la ServiceUri propiedad . El valor de la ServiceUri propiedad se recupera normalmente del archivo de configuración de la aplicación junto con otros valores de configuración.
Si el usuario se autentica correctamente, el proveedor de servicios establece la static
Thread.CurrentPrincipal propiedad en un nuevo ClientRolePrincipal objeto que contiene un nuevo ClientFormsIdentity objeto que contiene la información del usuario. ClientRoleProvider Si está configurado para la aplicación, puede usar el objeto para recuperar la ClientRolePrincipal información del rol de usuario del servicio de roles.
Puede recuperar una referencia a la instancia actual ClientFormsAuthenticationMembershipProvider a través de la static
Membership.Provider propiedad . Puede usar la referencia del proveedor de pertenencia para llamar al ClientFormsAuthenticationMembershipProvider.ValidateUser método directamente. Además, necesitará la referencia del proveedor de pertenencia para llamar al Logout método , que no está disponible en la MembershipProvider clase base.
No puede usar la ClientFormsAuthenticationMembershipProvider clase para crear, eliminar o modificar la información de pertenencia. Para crear, eliminar o modificar usuarios, debe cambiar la configuración del servicio de inicio de sesión en el servidor.
Constructores
ClientFormsAuthenticationMembershipProvider() |
Inicializa una nueva instancia de la clase ClientFormsAuthenticationMembershipProvider. |
Propiedades
ApplicationName |
Esta propiedad no se usa en esta clase. |
Description |
Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario. (Heredado de ProviderBase) |
EnablePasswordReset |
Esta propiedad no se usa en esta clase. |
EnablePasswordRetrieval |
Esta propiedad no se usa en esta clase. |
MaxInvalidPasswordAttempts |
Esta propiedad no se usa en esta clase. |
MinRequiredNonAlphanumericCharacters |
Esta propiedad no se usa en esta clase. |
MinRequiredPasswordLength |
Esta propiedad no se usa en esta clase. |
Name |
Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración. (Heredado de ProviderBase) |
PasswordAttemptWindow |
Esta propiedad no se usa en esta clase. |
PasswordFormat |
Esta propiedad no se usa en esta clase. |
PasswordStrengthRegularExpression |
Esta propiedad no se usa en esta clase. |
RequiresQuestionAndAnswer |
Esta propiedad no se usa en esta clase. |
RequiresUniqueEmail |
Esta propiedad no se usa en esta clase. |
ServiceUri |
Obtiene o establece el URI del servicio de autenticación. |
Métodos
ChangePassword(String, String, String) |
Este método no se usa en esta clase. |
ChangePasswordQuestionAndAnswer(String, String, String, String) |
Este método no se usa en esta clase. |
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
Este método no se usa en esta clase. |
DecryptPassword(Byte[]) |
Descifra una contraseña cifrada. (Heredado de MembershipProvider) |
DeleteUser(String, Boolean) |
Este método no se usa en esta clase. |
EncryptPassword(Byte[]) |
Cifra una contraseña. (Heredado de MembershipProvider) |
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) |
Cifra la contraseña especificada usando el modo de compatibilidad de contraseña especificado. (Heredado de MembershipProvider) |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
FindUsersByEmail(String, Int32, Int32, Int32) |
Este método no se usa en esta clase. |
FindUsersByName(String, Int32, Int32, Int32) |
Este método no se usa en esta clase. |
GetAllUsers(Int32, Int32, Int32) |
Este método no se usa en esta clase. |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetNumberOfUsersOnline() |
Este método no se usa en esta clase. |
GetPassword(String, String) |
Este método no se usa en esta clase. |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
GetUser(Object, Boolean) |
Este método no se usa en esta clase. |
GetUser(String, Boolean) |
Este método no se usa en esta clase. |
GetUserNameByEmail(String) |
Este método no se usa en esta clase. |
Initialize(String, NameValueCollection) |
Inicializa el proveedor. |
Logout() |
Cierra la sesión del usuario. |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
OnValidatingPassword(ValidatePasswordEventArgs) |
Genera el evento ValidatingPassword si se ha definido un controlador de eventos. (Heredado de MembershipProvider) |
ResetPassword(String, String) |
Este método no se usa en esta clase. |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
UnlockUser(String) |
Este método no se usa en esta clase. |
UpdateUser(MembershipUser) |
Este método no se usa en esta clase. |
ValidateUser(String, String) |
Autentica a un usuario con el nombre de usuario y contraseña especificados. |
ValidateUser(String, String, Boolean) |
Autentica a un usuario con el nombre de usuario y contraseña especificados y almacena opcionalmente un hash de la contraseña en la caché de datos local. |
ValidateUser(String, String, String) |
Autentica a un usuario en el URI del servicio especificado mediante el nombre de usuario y contraseña especificados. |
Eventos
UserValidated |
Se produce cuando se valida al usuario. |
ValidatingPassword |
Se produce cuando se crea un usuario o se cambia o se restablece una contraseña. (Heredado de MembershipProvider) |
Se aplica a
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de