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 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 ClientFormsAuthenticationMembershipProvider classe .

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

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

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

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

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

Você não pode usar a ClientFormsAuthenticationMembershipProvider classe 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)
• Serviços de aplicativo cliente
• Como configurar serviços de aplicativo cliente
• Como implementar logon e logoff do usuário com os Serviços de Aplicativos Cliente