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

Обновлен: Ноябрь 2007

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

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

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

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

В этом примере используется элемент управления PropertyGrid для доступа к свойствам параметров пользователей объекта My.Settings. По умолчанию в элементе управления PropertyGrid отображаются все свойства объекта My.Settings. Однако свойства параметров пользователей имеют атрибут UserScopedSettingAttribute. В этом примере свойству BrowsableAttributesPropertyGrid присваивается значение 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.

См. также

Задачи

Практическое руководство. Чтение параметров приложения в Visual Basic

Практическое руководство. Изменение пользовательских параметров в Visual Basic

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

Практическое руководство. Добавление или удаление параметров приложения

Ссылки

Объект My.Settings

Другие ресурсы

Управление параметрами приложения