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 seguinte exemplo de código demonstra como usar este método para validar o utilizador através de uma IClientFormsAuthenticationCredentialsProvider implementação.

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

Observações

Pode usar serviços de aplicação cliente para validar utilizadores através da autenticação de formulários. Para ativar a autenticação de formulários, configura a sua aplicação para usar a ClientFormsAuthenticationMembershipProvider classe.

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

A autenticação de formulários exige que o utilizador especifique as suas credenciais através dos controlos de login fornecidos pela sua aplicação. Podes recuperar as credenciais e entregá-las ao Membership.ValidateUser método. Também pode passar em cadeias vazias ou null usar um fornecedor de credenciais. Um fornecedor de credenciais é uma IClientFormsAuthenticationCredentialsProvider implementação especificada no ficheiro de configuração da sua aplicação. Normalmente, irá implementar o IClientFormsAuthenticationCredentialsProvider.GetCredentials método para mostrar uma caixa de diálogo de login e devolver um objeto preenchido ClientFormsAuthenticationCredentials . Usar um fornecedor de credenciais permite-lhe partilhar uma única caixa de diálogo de login entre várias aplicações.

O ClientFormsAuthenticationMembershipProvider.ValidateUser método autentica os utilizadores através do serviço de login indicado pela ServiceUri propriedade. O valor da ServiceUri propriedade é normalmente recuperado do ficheiro de configuração da aplicação juntamente com outros valores de configuração.

Se o utilizador for autenticado com sucesso, o fornecedor de serviços define a staticThread.CurrentPrincipal propriedade para um novo ClientRolePrincipal objeto que contém um novo ClientFormsIdentity objeto que contém a informação do utilizador. Se a ClientRoleProvider estiver configurado para a sua aplicação, pode usar o ClientRolePrincipal objeto para recuperar informações de papéis de utilizador do serviço de papéis.

Pode obter uma referência à instância atual ClientFormsAuthenticationMembershipProvider através da staticMembership.Provider propriedade. Pode usar a referência do fornecedor de membros para ligar diretamente ao ClientFormsAuthenticationMembershipProvider.ValidateUser método. Além disso, vai precisar da referência do fornecedor de membros para ligar ao Logout método, que não está disponível na MembershipProvider classe base.

Não pode usar a ClientFormsAuthenticationMembershipProvider classe para criar, eliminar ou modificar informações de membros. Para criar, eliminar ou modificar utilizadores, deve alterar a configuração do serviço de login no servidor.

Ver também

• ValidateUser
• ValidateUser(String, String)
• Serviços de Aplicações para Clientes
• Como: Configurar Serviços de Aplicações Cliente
• Como: Implementar o Login e Logout do Utilizador com os Serviços de Aplicações do Cliente