Поделиться через

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

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

Замечание

Чтобы этот пример работал, приложение должно настроить параметры пользователя. Дополнительные сведения см. в разделе "Управление параметрами приложения" (.NET).

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

Замечание

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

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

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

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

    Имя элемента управления property-grid по умолчанию является 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".

См. также