LocalFileSettingsProvider Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обеспечивает сохраняемость для классов параметров приложения.
public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProviderpublic class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvidertype LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProviderPublic Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider- Наследование
- Реализации
Комментарии
Поставщики параметров определяют механизм хранения данных конфигурации, используемых в архитектуре параметров приложения. Платформа .NET содержит один поставщик параметров по умолчанию, LocalFileSettingsProvider, который сохраняет данные конфигурации в локальной файловой системе. Свойство или группа свойств параметров приложения связаны с определенным поставщиком параметров с помощью свойства SettingsProviderAttribute.
Как правило, клиентская программа не имеет явного доступа к этому классу; Вместо этого архитектура параметров приложения автоматически вызывает соответствующего поставщика параметров, если требуются его службы. Например, многие члены делегирования ApplicationSettingsBase своей работы соответствующему поставщику параметров.
LocalFileSettingsProvider сохраняет параметры в файлах конфигурации с расширением .config. Содержимое файлов конфигурации структурировано как XML-документы. В зависимости от того, ограничивается ли параметр на уровне приложения или на уровне пользователя, данные конфигурации хранятся в виде элементов в <applicationSettings> группе разделов соответственно <userSettings> . Каждая из этих групп разделов представлена соответствующим AppSettingsSection или ClientSettingsSectionсоответственно. Каждый объект раздела принадлежит и управляется обработчиком раздела конфигурации, который является объектом типа IConfigurationSectionHandler.
Параметры с областью приложения и параметры, заданные пользователем по умолчанию, хранятся в файле с именем application.exe.config, который создается в том же каталоге, что и исполняемый файл. Параметры конфигурации приложения доступны только для чтения. Определенные данные пользователя хранятся в файле с именем user.config, хранящимся в домашнем каталоге пользователя. Если включены перемещаемые профили, могут существовать две версии файла конфигурации пользователя. В таком случае записи в перемещаемой версии имеют приоритет над повторяющимися записями в файле конфигурации локального пользователя.
Дополнительные сведения о параметрах приложения см. в разделе Application Settings for Windows Forms.
Конструкторы
| Имя | Описание |
|---|---|
| LocalFileSettingsProvider() |
Инициализирует новый экземпляр класса LocalFileSettingsProvider. |
Свойства
| Имя | Описание |
|---|---|
| ApplicationName |
Возвращает или задает имя запущенного в данный момент приложения. |
| Description |
Получает краткое понятное описание, подходящее для отображения в средствах администрирования или других пользовательских интерфейсах (UIs). (Унаследовано от ProviderBase) |
| Name |
Возвращает понятное имя, используемое для ссылки на поставщика во время настройки. (Унаследовано от ProviderBase) |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Возвращает значение свойства именованных параметров для предыдущей версии того же приложения. |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Возвращает коллекцию значений свойств для указанного экземпляра приложения и группы свойств параметров. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Initialize(String, NameValueCollection) |
Инициализирует поставщика. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Reset(SettingsContext) |
Сбрасывает все свойства параметров приложения, связанные с указанным приложением, в значения по умолчанию. |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Задает значения указанной группы параметров свойств. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Пытается перенести предыдущие параметры, заданные пользователем, из предыдущей версии того же приложения. |
