SettingsProvider Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выступает в качестве базового класса для получения пользовательских параметров поставщиков в архитектуре параметров приложения.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Наследование
- Производный
Комментарии
Поставщик параметров определяет механизм хранения данных конфигурации, используемых в архитектуре параметров приложения. Платформа .NET содержит один поставщик параметров по умолчанию, LocalFileSettingsProvider, который сохраняет данные конфигурации в локальной файловой системе. Однако можно создать альтернативные механизмы хранения, производные от абстрактного SettingsProvider класса. Поставщик, который использует класс-оболочка, определяется декорированием класса-оболочки с помощью SettingsProviderAttribute. Если этот атрибут не указан, LocalFileSettingsProviderиспользуется значение по умолчанию.
При создании поставщика пользовательских параметров, как минимум, необходимо предоставить реализации для трех методов этого класса: GetPropertyValuesSetPropertyValues и ApplicationName.
Для клиентских приложений можно добавить более стандартизованные функциональные возможности в настраиваемый поставщик, также реализуя IApplicationSettingsProvider интерфейс. Этот интерфейс зеркально отражает методы, ApplicationSettingsBase найденные в классе, что в основном обеспечивает поддержку управления версиями.
Как правило, следует использовать поставщики параметров разработки, чтобы избежать конфликтов ресурсов хранилища. Поставщики также должны быть потокобезопасными, так как их можно вызывать одновременно из нескольких экземпляров оболочки в одном домене приложения или из нескольких приложений в разных доменах.
Как минимум, поставщик параметров должен распознать три атрибута : ApplicationScopedSettingAttribute, UserScopedSettingAttributeи DefaultSettingValueAttribute. Полный список атрибутов, которые можно применить к параметрам приложения, см. в разделе "Атрибуты параметров приложения". Поставщик настраиваемых параметров должен разрешать атрибуты, применяемые к свойствам параметров следующим образом:
Если поставщик может выполнить запрос, подразумеваемый атрибутом, очевидно, он должен сделать это.
Если поставщик не может выполнить запрос, он должен игнорировать его автоматически.
Значение , если конфликт между двумя или более свойствами; например, свойство, украшенное обоими ApplicationScopedSettingAttribute и UserScopedSettingAttribute; поставщик должен вызвать ConfigurationExceptionисключение.
Конструкторы
| Имя | Описание |
|---|---|
| SettingsProvider() |
Инициализирует экземпляр SettingsProvider класса. |
Свойства
| Имя | Описание |
|---|---|
| ApplicationName |
Возвращает или задает имя запущенного в данный момент приложения. |
| Description |
Получает краткое понятное описание, подходящее для отображения в средствах администрирования или других пользовательских интерфейсах (UIs). (Унаследовано от ProviderBase) |
| Name |
Возвращает понятное имя, используемое для ссылки на поставщика во время настройки. (Унаследовано от ProviderBase) |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Возвращает коллекцию значений свойств параметров для указанного экземпляра приложения и группы свойств параметров. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Initialize(String, NameValueCollection) |
Инициализирует построитель конфигураций. (Унаследовано от ProviderBase) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Задает значения указанной группы параметров свойств. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
