Share via

Практическое руководство. Создание таблицы свойств для пользовательских параметров в Visual Basic

  • Статья

Вы можете создать таблицу свойств для параметров пользователя, заполнив элемент управления PropertyGrid свойствами параметров пользователей для объекта My.Settings.

Примечание.

Для надлежащего выполнения этого примера для приложения необходимо настроить пользовательские параметры. Дополнительные сведения см. в разделе Управление параметрами приложения (.NET).

Объект My.Settings представляет каждый параметр в виде свойства. Имя свойства совпадает с именем параметра, а тип свойства совпадает с типом параметра. Область параметра определяет, доступно ли свойство только для чтения. Свойство для параметра с областью Приложение доступно только для чтения, а свойство для параметра с областью Пользователь доступно для чтения или записи. Дополнительные сведения см. в разделе Объект My.Settings.

Примечание.

Невозможно изменить или сохранить значения параметров области определения приложения во время выполнения. Параметры области определения приложения можно изменить только при создании приложения (с помощью конструктора проектов) или путем изменения файла конфигурации приложения. Дополнительные сведения см. в разделе Управление параметрами приложения (.NET).

В этом примере элемент управления PropertyGrid используется для доступа к свойствам параметров пользователей объекта My.Settings. По умолчанию PropertyGrid отображает все свойства объекта My.Settings. Однако свойства параметров пользователей имеют атрибут UserScopedSettingAttribute. В данном примере для свойства BrowsableAttributes объекта PropertyGrid устанавливается значение UserScopedSettingAttribute, чтобы отображать только свойства параметров пользователей.

Добавление таблицы свойств параметров пользователей

  1. Добавьте элемент управления PropertyGrid из панели элементов в область конструктора для вашего приложения (здесь предполагается приложение Form1).

    Имя по умолчанию элемента управления таблицы свойств — PropertyGrid1.

  2. Дважды щелкните область конструктора для Form1, чтобы открыть код обработчика событий загрузки формы.

  3. Задайте объект My.Settings в качестве выделенного объекта для таблицы свойств.

    PropertyGrid1.SelectedObject = My.Settings

  4. Настройте таблицу свойств для отображения только параметров пользователей.

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

    Примечание.

    Чтобы отобразить только параметры области определения приложения, используйте атрибут ApplicationScopedSettingAttribute вместо UserScopedSettingAttribute.

Отказоустойчивость

Приложение сохраняет пользовательские параметры при завершении работы. Чтобы сохранить параметры немедленно, вызовите метод My.Settings.Save. Дополнительные сведения см. в разделе Практическое руководство. Сохранение пользовательских параметров в Visual Basic.

См. также