System.Configuration.LocalFileSettingsProvider Class

Provides persistence for application settings classes.

See Also: LocalFileSettingsProvider Members

Syntax

public class LocalFileSettingsProvider : SettingsProvider, IApplicationSettingsProvider

Remarks

Setting providers define a mechanism for storing configuration data used in the application settings architecture. The dnprdnshort contains a single default settings provider, System.Configuration.LocalFileSettingsProvider, which stores configuration data to the local file system. An application settings property or group of properties are associated to a specific settings provider through the use of the System.Configuration.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. For example, many of the members of System.Configuration.ApplicationSettingsBase delegate their work to the associated settings provider.

System.Configuration.LocalFileSettingsProvider persists settings to configuration files that have the extension .config. The contents of configuration files are structured as XML documents. 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. Each of these section groups is represented by a corresponding System.Configuration.AppSettingsSection or System.Configuration.ClientSettingsSection, respectively. Each section object is owned and administered by a configuration section handler, which is an object of type System.Configuration.IConfigurationSectionHandler.

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. 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.

For more information about application settings, see Application Settings for Windows Forms.

Requirements

Namespace: System.Configuration
Assembly: System (in System.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0
Since: .NET 2.0