Como: criar grades de propriedades para as configurações de usuário em Visual Basic

Você pode criar uma grade de propriedades para Configurações de Usuário preenchendo um controle PropertyGrid com as propriedades de configuração do usuário do objeto My.Settings.

Observação
Para que este exemplo funcione, seu aplicativo deve ter suas configurações de usuário configuradas.Para obter mais informações, consulte Gerenciamento de configurações do aplicativo.

O objeto My.Settings expõe cada configuração como uma propriedade.O nome da propriedade é o mesmo do nome da configuração, e o tipo da propriedade é o mesmo do tipo da configuração.O Scope da configuração determina se a propriedade é somente leitura; a propriedade para uma configuração com escopo de Application é somente para leitura, enquanto a propriedade para uma configuração com escopo de User é de leitura e escrita.Para obter mais informações, consulte Objeto My.Settings.

Observação
Você não pode alterar ou salvar os valores das configurações com escopo de aplicativo em tempo de execução.Configurações com escopo de aplicativo só podem ser alteradas ao criar o aplicativo (através do Project Designer) ou editando o arquivo de configuração do aplicativo.Para obter mais informações, consulte Gerenciamento de configurações do aplicativo.

Este exemplo usa um controle PropertyGrid para acessar as propriedades de configuração do usuário do objeto My.Settings.Por padrão, o PropertyGrid mostra todas as propriedades do objeto My.Settings.No entanto, as propriedades de configuração de usuário têm o atributo UserScopedSettingAttribute.Este exemplo define a propriedade BrowsableAttributes de PropertyGrid como UserScopedSettingAttribute para exibir somente as propriedades de configuração de usuário.

Adicionar uma grade de propriedade de configuração do usuário

1. Adicione o controle PropertyGrid da Toolbox para a superfície de design do seu aplicativo, assumido aqui como sendo Form1.

   O nome padrão do controle de grade de propriedade é PropertyGrid1.

2. Clique duas vezes na superfície de design para Form1 abrir o código para o manipulador de eventos de carregar formulário.

3. Defina o objeto My.Settings como o objeto selecionado para a grade propriedade.

   PropertyGrid1.SelectedObject = My.Settings
   

4. Configure a grade propriedade para mostrar somente as configurações de usuário.

   ' Attribute for the user-scope settings.
   Dim userAttr As New System.Configuration.UserScopedSettingAttribute
   Dim attrs As New System.ComponentModel.AttributeCollection(userAttr)
   PropertyGrid1.BrowsableAttributes = attrs
   

   Observação
   Para mostrar somente as configurações de escopo do aplicativo, use o atributo de ApplicationScopedSettingAttribute em vez de UserScopedSettingAttribute.

Programação robusta

O aplicativo salva as configurações de usuário quando o aplicativo é desligado.Para salvar as configurações imediatamente, chame o método My.Settings.Save.Para obter mais informações, consulte Como: manter configurações do usuário em Visual Basic.

Consulte também

Tarefas

Como: ler as configurações do aplicativo em Visual Basic

Como: alterar configurações de usuário em Visual Basic

Como: manter configurações do usuário em Visual Basic

Referência

Objeto My.Settings

Conceitos

Gerenciamento de configurações do aplicativo