LocalFileSettingsProvider LocalFileSettingsProvider LocalFileSettingsProvider LocalFileSettingsProvider Class

Определение

Обеспечивает сохраняемость для классов параметров приложений.Provides persistence for application settings classes.

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

Комментарии

Настройка поставщиков определяет механизм хранения данных конфигурации, используемых в архитектуре параметров приложения.Setting providers define a mechanism for storing configuration data used in the application settings architecture. Компонент содержит один поставщик параметров по умолчанию LocalFileSettingsProvider, который хранит данные конфигурации в локальной файловой системе. .NET Framework.NET FrameworkThe .NET Framework.NET Framework contains a single default settings provider, LocalFileSettingsProvider, which stores configuration data to the local file system. Свойство параметров приложения или группа свойств связаны с конкретным поставщиком параметров с помощью SettingsProviderAttribute.An application settings property or group of properties are associated to a specific settings provider through the use of the SettingsProviderAttribute.

Как правило, клиентская программа не обращается к этому классу явным образом; Вместо этого архитектура параметров приложения автоматически вызывает соответствующий поставщик параметров, когда требуются его службы.Typically, the client program does not explicitly access this class; rather, the application settings architecture automatically invokes the appropriate settings provider when its services are required. Например, многие члены ApplicationSettingsBase делегируют свою работу поставщику связанных параметров.For example, many of the members of ApplicationSettingsBase delegate their work to the associated settings provider.

LocalFileSettingsProviderсохраняет параметры в файлах конфигурации с расширением .config.LocalFileSettingsProvider persists settings to configuration files that have the extension .config. Содержимое файлов конфигурации структурировано как XML-документы.The contents of configuration files are structured as XML documents. В зависимости от того, ограничен ли параметр на уровне приложения или на уровне пользователя, данные конфигурации хранятся в виде элементов в <applicationSettings> группе <userSettings> разделов или, соответственно.Depending on whether the setting is scoped at either the application-level or user-level, the configuration data is stored as elements within an <applicationSettings> or a <userSettings> section group, respectively. Каждая из этих групп разделов представлена соответствующим AppSettingsSection образом или ClientSettingsSectionсоответственно.Each of these section groups is represented by a corresponding AppSettingsSection or ClientSettingsSection, respectively. Каждый объект раздела владеет и управляется обработчиком раздела конфигурации, который является объектом типа IConfigurationSectionHandler.Each section object is owned and administered by a configuration section handler, which is an object of type IConfigurationSectionHandler.

Параметры области приложения и параметры по умолчанию, заданные пользователем, хранятся в файле с именем application.exe.config, который создается в том же каталоге, что и исполняемый файл.Application-scoped settings and the default user-scoped settings are stored in a file named application.exe.config, which is created in the same directory as the executable file. Параметры конфигурации приложения доступны только для чтения.Application configuration settings are read-only. Определенные пользовательские данные хранятся в файле user.config, который хранится в домашнем каталоге пользователя.Specific user data is stored in a file named user.config, stored under the user's home directory. Если перемещаемые профили включены, может существовать две версии файла конфигурации пользователя.If roaming profiles are enabled, two versions of the user configuration file could exist. В этом случае записи в перемещаемой версии имеют приоритет над повторяющимися записями в локальном файле конфигурации пользователя.In such a case, the entries in the roaming version take precedence over duplicated entries in the local user configuration file.

Дополнительные сведения о параметрах приложения см. в разделе Параметры приложения для Windows Forms.For more information about application settings, see Application Settings for Windows Forms.

Конструкторы

LocalFileSettingsProvider() LocalFileSettingsProvider() LocalFileSettingsProvider() LocalFileSettingsProvider()

Инициализирует новый экземпляр класса LocalFileSettingsProvider.Initializes a new instance of the LocalFileSettingsProvider class.

Свойства

ApplicationName ApplicationName ApplicationName ApplicationName

Возвращает или задает имя работающего в данный момент приложения.Gets or sets the name of the currently running application.

Description Description Description Description

Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
Name Name Name Name

Возвращает понятное имя, используемое для ссылки на поставщика во время конфигурирования.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty)

Возвращает значение именованного свойства параметров для предыдущей версии того же приложения.Returns the value of the named settings property for the previous version of the same application.

GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Возвращает коллекцию значений свойств параметров для указанного экземпляра приложения и группу свойств параметров.Returns the collection of setting property values for the specified application instance and settings property group.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

Инициализирует поставщика.Initializes the provider.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext)

Сбрасывает все свойства параметров приложения, связанные с указанным приложением, к значениям по умолчанию.Resets all application settings properties associated with the specified application to their default values.

SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Задает значения указанной группы параметров свойств.Sets the values of the specified group of property settings.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection)

Выполняет попытку переместить предыдущие параметры на уровне пользователя из предыдущих версий того же приложения.Attempts to migrate previous user-scoped settings from a previous version of the same application.

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

Дополнительно