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 Framework содержит один поставщик параметров по умолчанию , LocalFileSettingsProviderкоторый хранит данные конфигурации в локальной файловой системе. Свойство параметров приложения или группа свойств связаны с определенным поставщиком параметров с помощью SettingsProviderAttribute.
Как правило, клиентская программа не обращается к этому классу явным образом; вместо этого архитектура параметров приложения автоматически вызывает соответствующий поставщик параметров, когда требуются его службы. Например, многие участники ApplicationSettingsBase делегируют свою работу связанному поставщику параметров.
LocalFileSettingsProvider Сохраняет параметры в файлы конфигурации с расширением .config. Содержимое файлов конфигурации структурировано в виде XML-документов. В зависимости от области действия параметра на уровне приложения или пользователя данные конфигурации хранятся в виде элементов в <applicationSettings> группе разделов <userSettings> или соответственно. Каждая из этих групп разделов представлена соответствующим AppSettingsSection или ClientSettingsSectionсоответственно. Каждый объект section принадлежит и администрируется обработчиком раздела конфигурации, который является объектом типа IConfigurationSectionHandler.
Параметры области приложения и параметры на уровне пользователя по умолчанию хранятся в файле с именем application.exe.config, который создается в том же каталоге, что и исполняемый файл. Параметры конфигурации приложения доступны только для чтения. Конкретные данные пользователя хранятся в файле с именем user.config, который хранится в домашнем каталоге пользователя. Если перемещаемые профили включены, могут существовать две версии файла конфигурации пользователя. В этом случае записи в перемещаемой версии имеют приоритет над повторяющимися записями в файле конфигурации локального пользователя.
Дополнительные сведения о параметрах приложения см. в разделе Параметры приложения для Windows Forms.
Конструкторы
| LocalFileSettingsProvider() |
Инициализирует новый экземпляр класса LocalFileSettingsProvider. |
Свойства
| ApplicationName |
Возвращает или задает имя работающего в данный момент приложения. |
| Description |
Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI). (Унаследовано от 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) |
Выполняет попытку переместить предыдущие параметры на уровне пользователя из предыдущих версий того же приложения. |
