LocalFileSettingsProvider Класс

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

LocalFileSettingsProvider.cs

Обеспечивает сохраняемость для классов параметров приложений.

public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider

public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

type LocalFileSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider

Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider

Наследование

Object

ProviderBase

SettingsProvider

LocalFileSettingsProvider

Реализации

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)	Выполняет попытку переместить предыдущие параметры на уровне пользователя из предыдущих версий того же приложения.

См. также раздел

• SettingsProviderAttribute
• ApplicationScopedSettingAttribute
• UserScopedSettingAttribute
• ApplicationSettingsBase
• ClientSettingsSection
• IConfigurationSectionHandler
• Архитектура параметров приложения