Visão geral dos serviços de aplicativos do cliente

Artigo
08/08/2011

Serviços de aplicativos de cliente fornecem acesso simplificado aos Microsoft Ajax login, funções e serviços de perfil do Windows Forms e aplicativos de Windows Presentation Foundation (WPF). Microsoft Ajaxos serviços de aplicativo estão incluídos na Microsoft ASP.NET 2.0 AJAX Extensions, que é incluído com 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: Configura os serviços de aplicativo do cliente.
Programação simples. Depois que você tiver habilitado e configurado os serviços do aplicativo cliente, você pode acessar os provedores de serviços indiretamente através de existentes .NET Framework 2.0 associação, funções e classes de configurações do aplicativo. Você pode acessar diretamente o .NET Framework versão 3.5 classes que implementam os serviços de aplicativo cliente. No entanto, na maioria dos casos, o acesso direto é desnecessário. Para obter mais informações sobre as classes de serviços de aplicativo do cliente, consulte o "cliente Serviços de Classes do aplicativo" seção 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 os serviços de aplicativos 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 Microsoft 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 Microsoft 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. Normalmente, você usará a autenticação de formulários com um aplicativo implantado na Internet.

Para validar um usuário, você chamar o método static Membership.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 Login do usuário com os serviços de aplicativos cliente.

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: Configura os serviços de aplicativo 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 obter informações sobre como configurar o Microsoft Ajax o serviço de autenticação, consulte Usando autenticação de formulários com o Microsoft Ajax.

Funções

Você pode usar os serviços do aplicativo cliente para recuperar informações de função de um existente Microsoft Ajax serviço de funções. Para determinar se o usuário autenticado atual está em uma determinada função, você chamar o IsInRole método o IPrincipal recuperados de referência da static Thread.CurrentPrincipal propriedade. O IsInRole método usa o nome da 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 os serviços de aplicativos cliente. Para obter informações sobre como configurar o Microsoft Ajax o serviço de funções, consulte Usando as informações sobre funções com o Microsoft Ajax.

Configurações

Você pode usar os serviços do aplicativo cliente para recuperar as configurações de aplicativo do usuário de uma já existente Microsoft Ajax perfil de serviço. O recurso de configurações do cliente aplicativo serviços Web integra-se com o recurso de configurações de aplicativo fornecido no .NET Framework 2.0. Para recuperar as configurações da Web, gerar primeiro um Settings classe (acessado como Properties.Settings.Default em C# e My.Settings na Visual Basic) para seu projeto usando o configurações guia da Visual Studio project designer. 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 sobre como configurar o Microsoft Ajax serviço de perfil, consulte Usando as informações do perfil com o Microsoft Ajax.

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.

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 de serviços de aplicativo cliente implementar ou estender o padrão .NET Framework 2.0 tipos, mas que não não implementar cada membro e um recurso definido desses 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
ClientFormsIdentity	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 static Thread.CurrentPrincipal.
ClientRolePrincipal	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 static Thread.CurrentPrincipal.
ConnectivityStatus	Essa classe fornece a propriedade static IsOffline que você utilizar para alternar o aplicativo para o modo off-line. Para obter mais informações, consulte Como: Trabalhar Offline com os serviços de aplicativos cliente.
ClientFormsAuthenticationCredentials	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.
ClientFormsAuthenticationMembershipProvider	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 static Membership.Provider.
ClientWindowsAuthenticationMembershipProvider	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 static Membership.Provider.
ClientRoleProvider	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: Configura os serviços de aplicativo 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 static Roles.Provider.
ClientSettingsProvider	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.
IClientFormsAuthenticationCredentialsProvider	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: Configura os serviços de aplicativo do cliente.
SettingsSavedEventArgs	Essa classe fornece uma propriedade FailedSettingsList para uso dentro uma ClientSettingsProvider.SettingsSaved manipulador de eventos.
UserValidatedEventArgs	Essa classe fornece uma propriedade UserName para uso dentro uma UserValidated manipulador de eventos.

Consulte também

Visão geral dos serviços de aplicativos do cliente

Autenticação

Funções

Configurações

Classes dos serviços de aplicativos do cliente

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais