ClientFormsAuthenticationMembershipProvider Classe

Definição

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

Herança

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Exemplos

O código de exemplo a seguir demonstra como usar esse método para validar o usuário usando uma implementação 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

Comentários

Você pode usar os serviços de aplicativo cliente para validar os usuários usando a autenticação de formulários. Para habilitar a autenticação de formulários, configure seu aplicativo para usar a classe ClientFormsAuthenticationMembershipProvider.

Após a configuração, você pode validar os usuários chamando o método staticMembership.ValidateUser, que chama internamente o método ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String).

A autenticação de formulários requer que o usuário especifique suas credenciais por meio de controles de logon fornecidos pelo aplicativo. Você pode recuperar as credenciais e passá-las para o método Membership.ValidateUser. Você também pode passar cadeias de caracteres vazias ou null para usar um provedor de credenciais. Um provedor de credenciais é uma implementação IClientFormsAuthenticationCredentialsProvider especificada no arquivo de configuração do aplicativo. Normalmente, você implementará o método IClientFormsAuthenticationCredentialsProvider.GetCredentials para exibir uma caixa de diálogo de logon e retornar um objeto ClientFormsAuthenticationCredentials preenchido. O uso de um provedor de credenciais permite que você compartilhe uma única caixa de diálogo de logon entre vários aplicativos.

O método ClientFormsAuthenticationMembershipProvider.ValidateUser autentica os usuários por meio do serviço de logon indicado pela propriedade ServiceUri. O valor da propriedade ServiceUri normalmente é recuperado do arquivo de configuração do aplicativo, juntamente com outros valores de configuração.

Se o usuário for autenticado com êxito, o provedor de serviços definirá a propriedade staticThread.CurrentPrincipal como um novo objeto ClientRolePrincipal que contém um novo objeto ClientFormsIdentity que contém as informações do usuário. Se um ClientRoleProvider estiver configurado para seu aplicativo, você poderá usar o objeto ClientRolePrincipal para recuperar informações de função de usuário do serviço de funções.

Você pode recuperar uma referência à instância de ClientFormsAuthenticationMembershipProvider atual por meio da propriedade staticMembership.Provider. Você pode usar a referência do provedor de associação para chamar o método ClientFormsAuthenticationMembershipProvider.ValidateUser diretamente. Além disso, você precisará da referência do provedor de associação para chamar o método Logout, que não está disponível na classe base MembershipProvider.

Você não pode usar a classe ClientFormsAuthenticationMembershipProvider para criar, excluir ou modificar informações de associação. Para criar, excluir ou modificar usuários, você deve alterar a configuração do serviço de logon no servidor.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• ValidateUser
• ValidateUser(String, String)
• de Serviços de Aplicativo Cliente
• Como configurar os Serviços de Aplicativo Cliente
• Como implementar logon e logoff do usuário com os Serviços de Aplicativo Cliente