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

Artigo
08/25/2010

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 Configurações da Web Serviços aplicativo cliente se integra com o recurso 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 adicionais sobre como configurar o serviço de perfis ASP.NET AJAX, consulte Usando Perfis de Informações com AJAX do ASP.NET.

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: Configurar serviços de aplicativos do cliente. Este procedimento requer acesso a uma serviço de funções ASP.NET AJAX em execução.Para obter orientação sobre testes ponto-a-ponto dos recursos de serviços aplicativo cliente, consulte Demonstra Passo a passo: Usando serviços aplicativo 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: Configurar serviços de aplicativos 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, uma classe Settings (acessada como Properties.Settings.Default em C# e My.Settings no Visual Basic)é gerada ou atualizada para incluir as 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 o Configurações página para modificar os valores de configurações padrão da Web, 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 serviços aplicativo cliente.

Consulte também

Share via

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

Conceitos

Referência

Outros recursos

Recursos adicionais