Como: Criar grades de propriedade para configurações de usuário no 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 informações sobre como adicionar configurações de usuário, consulte Como: Adicionar ou remover 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 de escopo de aplicativo podem ser alteradas apenas ao criar o aplicativo (por meio do Designer de projeto) ou editando o arquivo de configuração do aplicativo.Para obter mais informações, consulte Gerenciando definições de 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 de aplicativo, use o ApplicationScopedSettingAttribute atributo 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: Persist usuário Settings in Visual Basic.

Consulte também

Tarefas

Como: Ler configurações do aplicativo no Visual Basic

Como: Alterar configurações de usuário no Visual Basic

Como: Persist usuário Settings in Visual Basic

Como: Adicionar ou remover configurações do aplicativo

Referência

Objeto My.Settings

Outros recursos

Gerenciando definições de aplicativo