Compartilhar via

Como criar grades de propriedade para configurações de usuário no Visual Basic

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

Observação

Para que este exemplo funcione, seu aplicativo deve ter suas configurações de usuário definidas. Para obter mais informações, consulte Gerenciando as configurações do aplicativo (.NET).

O My.Settings objeto expõe cada configuração como uma propriedade. O nome da propriedade é o mesmo que o nome da configuração e o tipo de propriedade é o mesmo que o tipo de configuração. O Escopo da configuração determina se a propriedade é somente leitura. A propriedade para uma configuração de escopo do Aplicativo é somente leitura, enquanto que a propriedade para uma configuração de escopo do Usuário é de leitura/gravação. Para obter mais informações, consulte o objeto My.Settings.

Observação

Não é possível alterar ou salvar os valores das configurações de escopo do aplicativo em tempo de execução. As configurações de escopo do aplicativo só podem ser alteradas ao criar o aplicativo (por meio do Designer de Projeto) ou editar o arquivo de configuração do aplicativo. Para obter mais informações, consulte Gerenciando as configurações do aplicativo (.NET).

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

Para adicionar uma grade de propriedades de configuração do usuário

  1. Adicione o controle PropertyGrid da Caixa de Ferramentas à superfície de design do aplicativo, assumida aqui como sendo Form1.

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

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

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

    PropertyGrid1.SelectedObject = My.Settings

  4. Configure a grade de propriedades para mostrar apenas as configurações do 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 apenas as configurações de escopo do aplicativo, use o ApplicationScopedSettingAttribute atributo em vez de UserScopedSettingAttribute.

Programação robusta

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

Consulte também

  • Last updated on