ConfigurationManager.OpenMappedExeConfiguration Method (ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Opens the specified client configuration file as a Configuration object that uses the specified file mapping, user level, and preload option.

Namespace:   System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)

public static Configuration OpenMappedExeConfiguration(
	ExeConfigurationFileMap fileMap,
	ConfigurationUserLevel userLevel,
	bool preLoad


Type: System.Configuration.ExeConfigurationFileMap

An ExeConfigurationFileMap object that references the configuration file to use instead of the default application configuration file.

Type: System.Configuration.ConfigurationUserLevel

The ConfigurationUserLevel object for which you are opening the configuration.

Type: System.Boolean

true to preload all section groups and sections; otherwise, false.

Return Value

Type: System.Configuration.Configuration

The configuration object.

Exception Condition

A configuration file could not be loaded.

The ConfigurationUserLevel object determines the location of the configuration file that is being opened. It indicates whether the file has no user level (the configuration file is in the same directory as the application) or has a per-user level (the configuration file is in an application settings path that is determined by userLevel).


To obtain the Configuration object for a resource, your code must have read permissions on all the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write permissions for both the configuration file and the directory in which it exists.

For a code example, see the OpenMappedExeConfiguration overload.

.NET Framework
Available since 4.5
Return to top