Атрибуты параметров приложения
Обновлен: Ноябрь 2007
Архитектура параметров приложения обеспечивает целый ряд атрибутов, которые могут быть применены к классу-оболочке параметров приложения или к отдельным свойствам этого класса. Данные атрибуты проверяются во время выполнения инфраструктурой параметров приложения (обычно поставщиком параметров), чтобы настроить работу приложения в соответствии с указанными потребностям пользовательской программы-оболочки.
Ниже перечислены атрибуты, которые могут быть применены к классу-оболочке параметров приложения, к отдельным свойствам этого класса или и к классу, и к свойствам. По определению, к каждому свойству параметров должен быть применен только один атрибут области определения — UserScopedSettingAttribute или ApplicationScopedSettingAttribute.
.gif "Примечание") Примечание. |
|---|
Для распознавания трех атрибутов, перечисленных далее, требуется только пользовательский поставщик параметров, производный от класса SettingsProvider: ApplicationScopedSettingAttribute, UserScopedSettingAttribute и DefaultSettingValueAttribute. |
Атрибут |
Назначение |
Описание |
|---|---|---|
Класс и его свойства |
Указывает короткое имя поставщика параметров, используемого для сохранения. Если этот атрибут не задан, используется поставщик по умолчанию — LocalFileSettingsProvider. |
|
Класс и его свойства |
Определяет свойство как параметр с областью определения пользователя. |
|
Класс и его свойства |
Определяет свойство как параметр с областью определения приложения. |
|
Свойство |
Указывает строку, которая может быть десериализована поставщиком в жестко заданное значение по умолчанию для этого свойства. Для поставщика LocalFileSettingsProvider этот атрибут не требуется; поставщик переопределит любое значение, возвращаемое этим атрибутом, при наличии уже сохраненного значения. |
|
Свойство |
Предоставляет описательные тесты для отдельных параметров, в основном используется средствами времени выполнения и разработки. |
|
Класс |
Содержит явное имя группы параметров. Если этот атрибут отсутствует, класс ApplicationSettingsBase использует имя класса-оболочки. |
|
Класс |
Предоставляет описательный тест для группы параметров, в основном используется средствами времени выполнения и разработки. |
|
Класс и его свойства |
Указывает ноль или более служб управляемости, которые должны предоставляться группе параметров или свойству. Доступные службы описаны перечислением SettingsManageability. |
|
Свойство |
Показывает, что параметр принадлежит к особой предопределенной категории, такой как строка подключения, и, в силу этого, должен обрабатываться поставщиком параметров особым образом. Предопределенные категории для этого атрибута определены перечислением SpecialSetting. |
|
Класс и его свойства |
Задает предпочтительный механизм сериализации для группы параметров или свойства. Доступные механизмы сериализации определены перечислением SettingsSerializeAs. |
|
Свойство |
Указывает, что поставщик параметров должен отключить всю функциональность обновления приложения для помеченного свойства. |
Класс указывает, что атрибут может быть применен только к классу-оболочке параметров приложения. Свойство указывает, что атрибут может быть применен только к свойствам параметров. Класс и его свойства указывает, что атрибут может применяться на обоих уровнях.
См. также
Задачи
Практическое руководство. Создание параметров приложения с помощью конструктора
Основные понятия
Архитектура параметров приложения