Partilhar via

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

  • Artigo

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.

Nota

Para que este exemplo funcione, seu aplicativo deve ter suas configurações de usuário definidas. Para obter mais informações, consulte Gerenciando 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 Application-scope é somente leitura, enquanto a propriedade para uma configuração User-scope é leitura-gravação. Para obter mais informações, consulte Objeto My.Settings.

Nota

Não é possível alterar ou salvar os valores das configurações do escopo do aplicativo em tempo de execução. As configurações do escopo do aplicativo podem ser alteradas somente ao criar o aplicativo (por meio do Project Designer) ou editando o arquivo de configuração do aplicativo. Para obter mais informações, consulte Gerenciando 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 My.Settings objeto. No entanto, as propriedades de configuração do usuário têm o UserScopedSettingAttribute atributo. Este exemplo define a BrowsableAttributes propriedade do to UserScopedSettingAttribute para exibir somente as propriedades de configuração do PropertyGrid usuário.

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

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

    O nome padrão do controle property-grid é PropertyGrid1.

  2. Clique duas vezes na superfície de design para Form1 abrir o código para o manipulador de eventos de carga 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

    Nota

    Para mostrar apenas as configurações do 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 persistir configurações de usuário no Visual Basic.

Consulte também