Visão geral dos serviços de aplicativos do cliente
Os serviços do aplicativo cliente fornecem acesso simplificado a ASP.NET AJAX logon, funções e serviços de analisar de aplicativos Windows Forms e o Windows Presentation Foundation (WPF). ASP.NET AJAX serviços de aplicativos incluídos na Microsoft ASP.NET 2.0 AJAX Extensions, que está incluído no Visual Studio 2008 e o .NET Framework versão 3.5. Estes serviços permitem que vários da e aplicativos da Web e baseados no Windows compartilhem informações do usuário e funcionalidade de gerenciamento de usuários de um único servidor.
Serviços de aplicativos cliente incluem provedores de serviço de cliente que conecte o modelo de extensibilidade serviços da Web para ativar os seguintes recursos para aplicativos baseados no Windows:
Configuração simples do cliente.Você pode habilitar e configurar o logon, funções e serviços de perfil usando o Visual Studio projeto Designer ou especificando provedores de serviço de cliente no arquivo App.config do seu projeto.Para obter mais informações, consulte Como: Configurar serviços de aplicativos do cliente.
Programação simples.Após ter ativado e configurado serviços aplicativo cliente, você pode acessar os provedores de serviços indiretamente através de existente .NET Framework 2,0 associação, funções e classes Configurações do aplicativo.Você pode acessar também diretamente as .NET Framework versão 3,5 Service Pack 1 classes que implementam serviços aplicativo cliente.No entanto, na maioria dos casos, acesso direto é desnecessário. Para obter mais informações sobre as classes de serviços de aplicativo cliente, consulte a seção "Client Application Services Classes" deste tópico.
Suporte off-line.Aplicativos baseados no Windows geralmente têm que operar em ambientes ocasionalmente conectados.Quando seu aplicativo está on-line, os provedores de serviços de cliente serão cache valores recuperados do servidor para uso quando o aplicativo está off-line.Para obter mais informações, consulte Como: Trabalhar offline com serviços de aplicativos do cliente.
Integração com o designer Visual Studio Configurações do aplicativo.Quando você adiciona as configurações em seu projeto no Visual Studio,você pode especificar quais configurações devem ser acessados por meio de provedor de serviços as configurações do cliente.
As seções a seguir descrevem essas propriedades com mais detalhes.Para obter mais informações sobre os serviços de aplicativos ASP.NET AJAX, consulte Visão geral sobre Serviços de Aplicativos ASP.NET.
Autenticação
Você pode usar Serviços aplicativo cliente para validar um usuário a um serviço de autenticação ASP.NET AJAX existentes.Você pode validar um usuário usando a autenticação do Windows ou formulários.A autenticação do Windows significa que a identidade do usuário é aquele fornecido pelo sistema operacional quando um usuário efetua logon on to um computador ou domínio.Você geralmente usará a autenticação do Windows com um aplicativo implantado em uma intranet corporativa.A autenticação de formulários significa que você deve incluir controles de logon no seu aplicativo e passar as credenciais adquiridas para o provedor de autenticação.Você geralmente usará a autenticação de formulários com um aplicativo implantado na Internet.
Para validar um usuário, você chamar o método staticMembership.ValidateUser.Esse método acessa o provedor de serviço de cliente configurado para o seu aplicativo e retorna um valor Boolean indicando se o usuário é válido.Para obter mais informações, consulte Como: Implementar o logon de usuário e efetuar Logout com aplicativo cliente Services.
Ao usar a autenticação do Windows, você deve passar sequências de caracteres vazias ou null como os parâmetros do método ValidateUser.Ao usar a autenticação do Windows, este chamada de método sempre retornará true.
Com autenticação de formulários, o método ValidateUser retornará um valor que indica se o serviço remoto foi autenticada do usuário.Se a validação tiver êxito, um cookie de autenticação é armazenado no disco rígido o local.Esse cookie é usado para confirmar a validação ao acessar as funções e serviços configurações.
Ao usar a autenticação de formulários, você pode passar um nome de usuário e uma senha para o método ValidateUser.Você também pode passar sequências de caracteres vazias ou null como os parâmetros para usar um provedor de credenciais.Um provedor de credenciais é uma classe que você forneça e especificar em sua configuração de aplicativo.Uma classe provedor de credenciais deve implementar a interface IClientFormsAuthenticationCredentialsProvider, que tem um único método chamado GetCredentials.Usar um provedor de credenciais permite que você compartilhar um único logon caixa de diálogo entre vários aplicativos.Para obter mais informações, consulte Como: Configurar serviços de aplicativos do cliente.
Quando você configura seu aplicativo para usar um provedor de credenciais com autenticação de formulários, você deve passar sequências de caracteres vazias ou null como os parâmetros do método ValidateUser.O provedor de serviços, em seguida, chamará sua implementação o método IClientFormsAuthenticationCredentialsProvider.GetCredentials.Normalmente, você implementará este método para exibir um caixa de diálogo e retornar um objeto ClientFormsAuthenticationCredentials preenchido.
Para mais informações sobre virtualização, consulte Autenticação do ASP.NET.Para informações sobre como configurar o serviço de autenticação ASP.NET AJAX, veja Usando Formulários de Autenticação com AJAX do ASP.NET.
Funções
Você pode usar os serviços de aplicativos cliente para recuperar informações dos papéis de um serviço de funções ASP.NET AJAX existentes.Para determinar se o atual, usuário autenticado está em uma função específica, você chamar o método IsInRole da referência IPrincipal recuperado da propriedade staticThread.CurrentPrincipal.O método IsInRole usa o nome de função como um parâmetro e retorna um Boolean valor que indica se o usuário atual está na função especificada.Este método retornará false se o usuário não está autenticado ou não está na função especificada.
Para obter mais informações, consulte Como: Funções de usuário de acesso com aplicativo cliente Services. Para informações sobre como configurar o serviço de funções ASP.NET AJAX, veja Usando Funções de Informações com AJAX do ASP.NET.
Configurações
Você pode usar Serviços aplicativo cliente para recuperar configurações de usuário do aplicativo de um serviço ASP.NET AJAX do perfil existente.O recurso de configurações cliente Web serviços de aplicativo integra o recurso de configurações de aplicativo fornecido no .NET Framework 2,0. Para recuperar sistema autônomo configurações da Web, gerar primeiro um Settings classe (acessada sistema autônomo Properties.Settings.Default em translation from VPE for Csharp e My.Settings em Visual Basic) para seu projeto usando o Configurações Guia de do Visual Studio designer de projeto. Na guia Settings, você pode usar o Configurações da Web O Botão para recuperar as configurações da Web e adicioná-los para a classe Settings gerada.Você pode usar configurações configuradas para serem usados por todos os usuários autenticados ou Todos os usuários anônimos da Web.
Para obter mais informações, consulte Como: Configurações de usuário de acesso com os serviços de aplicativos cliente. Para obter mais informações, consulte Visão Geral Sobre Configurações do Aplicativo.Para obter informações adicionais sobre como implementar sua própria classe Configurações, em vez de gerar um Visual Studio,consulte Como: Criar configurações do aplicativo.Para obter informações adicionais sobre como configurar o serviço de perfis ASP.NET AJAX, consulte Usando Perfis de Informações com AJAX do ASP.NET.
Classes dos serviços de aplicativos do cliente
A tabela a seguir descreve as classes que implementam o recurso Serviços aplicativo cliente.
Aplicativos que usam apenas a autenticação primária, funções e recursos Configurações não precisará acessar essas classes diretamente.Em vez disso, esses aplicativos acessará os provedores serviço de aplicativos cliente indiretamente usando a configuração de aplicativos e as APIs descrita nas seções anteriores.Você irá acessar essas classes diretamente para implementar recursos adicionais, como logoff de usuário e recurso off-line.
.gif "Observação") Observação: |
|---|
Todos os serviços aplicativo cliente APIs são síncronos.Serviços de aplicativos cliente oferece suporte direto ao comportamento assíncrono. |
Os provedores serviço de aplicativos cliente implementam ou estendem .NET Framework 2,0 Tipos padrão, mas não implementam cada membro e recurso definido por esses tipos.Por exemplo, você não pode usar os provedores serviço de aplicativos cliente para implementar um usuário - aplicativo de gerenciamento para criar novos usuários e gerenciar o membro da função.Para implementar essa funcionalidade, você deve usar atualmente um aplicativo da Web e código do lado do servidor.Para determinar quais membros não são implementados, consulte a documentação de referência, que pode ser acessada a partir dos links na tabela.
Classe |
Descrição |
|---|---|
Essa classe gerencia os cookies de identidades e de autenticação do usuário para autenticação de formulários. O principal motivo para acessar diretamente dessa classe é chamar o método RevalidateUser, qual silenciosamente revalidates um usuário (exemplo, quando você alterna de off-line para o modo on-line). Depois que o usuário é autenticado usando a autenticação de formulários, você pode recuperar uma instância da classe este através da propriedade Identity da referência IPrincipal recuperada através da propriedade staticThread.CurrentPrincipal. |
|
Essa classe gerencia as funções de usuário. Esta classe não tem todos os membros que não podem ser acessados indiretamente.No entanto, depois que o usuário é autenticado, você pode acessar uma instância da classe este através da propriedade staticThread.CurrentPrincipal. |
|
Essa classe fornece a propriedade staticIsOffline que você utilizar para alternar o aplicativo para o modo off-line.Para obter mais informações, consulte Como: Trabalhar offline com serviços de aplicativos do cliente. |
|
Esta classe representa as credenciais do usuário. You will use this class only as the return value type of the GetCredentials method when you implement the IClientFormsAuthenticationCredentialsProvider interface. |
|
Essa classe gerencia o acesso para o remoto serviço de autenticação para a autenticação de formulários. O principal motivo para acessar diretamente dessa classe é usar seu Logout e UserValidated membros, que não são implementados pela classe base MembershipProvider.Você pode também definir o local do serviço por meio de programação, usando a propriedade ServiceUri. Você pode recuperar uma instância da classe este através da propriedade staticMembership.Provider. |
|
Essa classe gerencia a autenticação do Windows. O principal motivo para acessar diretamente dessa classe é chamar o método Logout.Após logout, o usuário ainda será autenticado para Windows, mas será possível acessar os serviços de aplicativo remoto. Você pode recuperar uma instância da classe este através da propriedade staticMembership.Provider. |
|
Essa classe gerencia o acesso para o remoto serviço de funções. O principal motivo para acessar diretamente dessa classe é chamar o método ResetCache.Isso pode ser útil se seu aplicativo é configurado para usar um cache valor de tempo limite non-zero serviço de função.Para obter mais informações, consulte Como: Configurar serviços de aplicativos do cliente. Você pode também definir o local do serviço por meio de programação, usando a propriedade ServiceUri. Você pode recuperar uma instância da classe este através da propriedade staticRoles.Provider. |
|
Essa classe gerencia o acesso para o remoto serviço de configurações Web. O principal motivo para acessar essa classe é manipular o evento SettingsSaved.Você pode também definir o local do serviço por meio de programação, usando a propriedade ServiceUri. |
|
Essa interface fornece uma maneira indireta para seu aplicativo para adquirir as credenciais do usuário para validação, conforme descrito anteriormente na seção Autenticação neste tópico.Para obter mais informações, consulte Como: Configurar serviços de aplicativos do cliente. |
|
Essa classe fornece uma propriedade FailedSettingsList para uso dentro uma ClientSettingsProvider.SettingsSaved manipulador de eventos. |
|
Essa classe fornece uma propriedade UserName para uso dentro uma UserValidated manipulador de eventos. |
Consulte também
Tarefas
Como: Configurar serviços de aplicativos do cliente
Como: Implementar o logon de usuário e efetuar Logout com aplicativo cliente Services
Como: Funções de usuário de acesso com aplicativo cliente Services
Como: Configurações de usuário de acesso com os serviços de aplicativos cliente
Como: Trabalhar offline com serviços de aplicativos do cliente
Demonstra Passo a passo: Usando serviços aplicativo cliente
Conceitos
Visão Geral Sobre Configurações do Aplicativo
Visão geral sobre Serviços de Aplicativos ASP.NET
Usando Formulários de Autenticação com AJAX do ASP.NET
Usando Funções de Informações com AJAX do ASP.NET
Usando Perfis de Informações com AJAX do ASP.NET
Outros recursos
Serviços de Aplicativo Cliente
Gerenciando definições de aplicativo
Gerenciando Autorização Usando Funções
Criando e Configurando o Banco de Dados dos Serviços de Aplicativos para o SQL Server