Como: Configurações de usuário de acesso com os serviços de aplicativos cliente

Artigo
08/08/2011

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 obter mais informações, consulte Visão Geral Sobre 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.

Descreve como acessar configurações da Web do usuário quando seu aplicativo está configurado para usar o cliente do provedor de configurações. Para obter mais informações, consulte Como: Configura os serviços de aplicativo do cliente. Este procedimento requer o acesso a uma execução Microsoft Ajax perfil de serviço. Para obter orientação sobre testes ponto-a-ponto dos recursos de serviços aplicativo cliente, consulte Demonstra Passo a passo: Usando os serviços de aplicativo do cliente.

Para acessar configurações da Web no seu Windows aplicativo cliente

Garantir que seu aplicativo é configurado para usar serviços aplicativo cliente, conforme descrito em Como: Configura os serviços de aplicativo do cliente apropriada. No mínimo, você deve especificar um local serviço de configurações Web na página Services do criador do projeto. Para recuperar configurações da Web configuradas para ser usado por usuários autenticados, você também deve especificar um local serviço de autenticação ou usar a autenticação do Windows.
Na página Settings do criador do projeto, clique em Configurações Carregar da Web.

Aparece um caixa de diálogo Login.

Para recuperar as configurações definidas no servidor para uso por todos os usuários autenticados, especifique credenciais de usuário válido e clique em Fazer logon no . Para recuperar as configurações definidas para uso por todos os usuários anônimos, clique em Ignorar logon .

As configurações configuradas no servidor aparecerão no designer. Além disso, um Settings classe (acessado como Properties.Settings.Default em C# e My.Settings na Visual Basic) é gerado ou atualizado para incluir propriedades com base nas configurações. Essa classe gerencia todas as interações com o serviço de configurações Web remoto por meio da classe ClientSettingsProvider. Embora você possa acessar a classe ClientSettingsProvider diretamente, você será normalmente acessá-lo indiretamente por meio da classe Settings,conforme mostrado na próxima etapa. Para obter mais informações, consulte Visão geral dos serviços de aplicativos do cliente.

Observação
Não é possível usar a página Settings para modificar os valores padrão da Web Configurações nem para acessar valores não padrão. Além disso, se os valores padrão são modificados no servidor, você deve recuperar os novos valores padrão, clicando em Configurações da Web O Botão. O botão S ynchronize não é usado pelos serviços aplicativo cliente.

No seu código do aplicativo, use propriedades da classe gerada para obter ou definir os valores Configurações da Web.

O exemplo de código a seguir pressupõe que você ter recuperado uma configuração denominada MySetting e que seu aplicativo contém uma Label chamado myLabel.
```
My.Settings.MySetting = "test"
myLabel.Text = My.Settings.MySetting
```
```
Properties.Settings.Default.MySetting = "test";
myLabel.Text = Properties.Settings.Default.MySetting;
```
No seu código do aplicativo, use o método ApplicationSettingsBase.Save para salvar as configurações alteradas valores de volta para o serviço de configurações Web.
```
My.Settings.Save()
```
```
Properties.Settings.Default.Save();
```

Programação robusta

O exemplo de código neste tópico demonstra o uso mais simples do serviço de funções em um aplicativo cliente Windows. Quando você Acessar ou Salvar Configurações da Web por meio de serviços aplicativo cliente, no entanto, seu código pode acionar uma WebException. Isso indica que o serviço está indisponível ou que o logon do usuário expirou. Para obter um exemplo de como tratar um WebException nesse caso, consulte Demonstra Passo a passo: Usando os serviços de aplicativo do cliente.

Consulte também

Como: Configurações de usuário de acesso com os serviços de aplicativos cliente

Para acessar configurações da Web no seu Windows aplicativo cliente

Programação robusta

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais