Поделиться через


LocalFileSettingsProvider Класс

Определение

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

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
Наследование
LocalFileSettingsProvider
Реализации

Комментарии

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

Выполняет попытку переместить предыдущие параметры на уровне пользователя из предыдущих версий того же приложения.

Применяется к

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