ClientFormsAuthenticationMembershipProvider Clase

Definición

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

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Ejemplos

En el código de ejemplo siguiente se muestra cómo usar este método para validar al usuario mediante una implementación de IClientFormsAuthenticationCredentialsProvider.

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 servicios de aplicaciones 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 clase ClientFormsAuthenticationMembershipProvider.

Después de la configuración, puede validar a los usuarios llamando al método staticMembership.ValidateUser, que llama internamente al método ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String).

La autenticación de formularios requiere que el usuario especifique sus credenciales mediante controles de inicio de sesión proporcionados por la aplicación. Puede recuperar las credenciales y pasarlas al método Membership.ValidateUser. También puede pasar cadenas vacías o null para usar un proveedor de credenciales. Un proveedor de credenciales es una implementación IClientFormsAuthenticationCredentialsProvider especificada en el archivo de configuración de la aplicación. Normalmente, implementará el método IClientFormsAuthenticationCredentialsProvider.GetCredentials para mostrar un cuadro de diálogo de inicio de sesión y devolver un objeto ClientFormsAuthenticationCredentials rellenado. El uso de un proveedor de credenciales permite compartir un único cuadro de diálogo de inicio de sesión entre varias aplicaciones.

El método ClientFormsAuthenticationMembershipProvider.ValidateUser autentica a los usuarios a través del servicio de inicio de sesión indicado por la propiedad ServiceUri. El valor de la propiedad ServiceUri 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 propiedad staticThread.CurrentPrincipal en un nuevo objeto ClientRolePrincipal que contiene un nuevo objeto ClientFormsIdentity que contiene la información del usuario. Si un ClientRoleProvider está configurado para la aplicación, puede usar el objeto ClientRolePrincipal para recuperar la información de rol de usuario del servicio de roles.

Puede recuperar una referencia a la instancia de ClientFormsAuthenticationMembershipProvider actual a través de la propiedad staticMembership.Provider. Puede usar la referencia del proveedor de pertenencia para llamar directamente al método ClientFormsAuthenticationMembershipProvider.ValidateUser. Además, necesitará la referencia del proveedor de pertenencia para llamar al método Logout, que no está disponible en la clase base MembershipProvider.

No puede usar la clase ClientFormsAuthenticationMembershipProvider para crear, eliminar ni 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

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• ValidateUser
• ValidateUser(String, String)
• servicios de aplicaciones cliente de
• Configuración de servicios de aplicaciones cliente
• Cómo: Implementar el inicio de sesión de usuario y el cierre de sesión con los servicios de aplicaciones cliente