ConfigurationManager.OpenExeConfiguration Method (String)
Assembly: System.Configuration (in system.configuration.dll)
'Declaration Public Shared Function OpenExeConfiguration ( _ exePath As String _ ) As Configuration 'Usage Dim exePath As String Dim returnValue As Configuration returnValue = ConfigurationManager.OpenExeConfiguration(exePath)
The path to the configuration file associated with the executable file.
Return ValueA Configuration object.
A configuration file could not be loaded.
Client applications use a global configuration that applies to all users, separate configurations that apply to individual users, and configurations that apply to roaming users. The userLevel value determines the location of the configuration file being opened by indicating whether it 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 determined by the user level type.).
Specify which configuration to get by passing one of the following values for the userLevel parameter:
To get the Configuration that applies to all users, set userLevel to None.
To get the local Configuration that applies to the current user, set userLevel to PerUserRoamingAndLocal.
To get the roaming Configuration that applies to the current user, set userLevel to PerUserRoaming.
To obtain the Configuration object for a resource, your code must have read privileges on all of the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write privileges for both the configuration file and the directory in which it exists.
The following code example shows how to use the OpenExeConfiguration method to modify a custom configuration section.
' Modify a custom section. ' Show how to use the ' OpenExeConfiguration(ConfigurationUserLevel, ' config file path) method. Shared Sub ModifyCustomSection2() ' Get the application configuration file. Dim config As System.Configuration.Configuration = _ ConfigurationManager.OpenExeConfiguration( _ ConfigurationUserLevel.None) Dim custSection As CustomSection = _ config.Sections(customSectionName) custSection.FileName = "anotherName.txt" custSection.MaxIdleTime = New TimeSpan(0, 20, 0) custSection.MaxUsers = custSection.MaxUsers + 20 If Not custSection.ElementInformation.IsLocked Then config.Save() Else Console.WriteLine("Section was locked, could not update.") End If End Sub 'ModifyCustomSection2
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.