ConfigurationManager.OpenMappedExeConfiguration Method (ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)
Opens the specified client configuration file as a Configuration object that uses the specified file mapping, user level, and preload option.
Assembly: System.Configuration (in System.Configuration.dll)
public static Configuration OpenMappedExeConfiguration( ExeConfigurationFileMap fileMap, ConfigurationUserLevel userLevel, bool preLoad )
Parameters
- fileMap
-
Type:
System.Configuration.ExeConfigurationFileMap
An ExeConfigurationFileMap object that references the configuration file to use instead of the default application configuration file.
- userLevel
-
Type:
System.Configuration.ConfigurationUserLevel
The ConfigurationUserLevel object for which you are opening the configuration.
- preLoad
-
Type:
System.Boolean
true to preload all section groups and sections; otherwise, false.
| Exception | Condition |
|---|---|
| ConfigurationErrorsException | 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).
Note |
|---|
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.
Available since 4.5
