Partilhar via

Como criar grelhas de propriedades para definiçõ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 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 é só de leitura; a propriedade para uma configuração de escopo de aplicação é só de leitura, enquanto a propriedade para uma configuração de escopo de usuário é de leitura e escrita. Para obter mais informações, consulte Objeto My.Settings.

Observação

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 propriedade BrowsableAttributes do PropertyGrid para UserScopedSettingAttribute para exibir somente as propriedades de configuração do 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, para abrir o código do evento de carregamento do 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 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.

Ver também

  • Last updated on