ConfigurationManager.OpenMachineConfiguration Method ()
Opens the machine configuration file on the current computer as a Configuration object.
Assembly: System.Configuration (in System.Configuration.dll)
| Exception | Condition |
|---|---|
| ConfigurationErrorsException | A configuration file could not be loaded. |
Machine configuration settings apply to the whole computer and all applications that reside on it, unless overridden for the local application. Machine configuration settings are read from the Machine.config file of the currently running version of the .NET Framework. The Machine.config file is located in the following subdirectory:
%windir%\Microsoft.NET\Framework\version\config
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. It is not possible to access the Machine.config file for other versions of the .NET Framework that might be installed on the computer. |
The following code example shows how to use the OpenMachineConfiguration method to obtain all sections that are contained in the configuration file.
' Access the machine configuration file using mapping. ' The function uses the OpenMappedMachineConfiguration ' method to access the machine configuration. Public Shared Sub MapMachineConfiguration() ' Get the machine.config file. Dim machineConfig As Configuration = _ ConfigurationManager.OpenMachineConfiguration() ' Get the machine.config file path. Dim configFile _ As New ConfigurationFileMap( _ machineConfig.FilePath) ' Map the application configuration file ' to the machine configuration file. Dim config As Configuration = _ ConfigurationManager. _ OpenMappedMachineConfiguration( _ configFile) ' Get the AppSettings section. Dim appSettingSection As AppSettingsSection = _ DirectCast(config.GetSection("appSettings"), _ AppSettingsSection) appSettingSection.SectionInformation. _ AllowExeDefinition = _ ConfigurationAllowExeDefinition. _ MachineToRoamingUser ' Display the configuration file sections. Dim sections As _ ConfigurationSectionCollection = _ config.Sections Console.WriteLine() Console.WriteLine( _ "Using OpenMappedMachineConfiguration.") Console.WriteLine( _ "Sections in machine.config:") ' Get the sections in the machine.config. For Each section _ As ConfigurationSection In sections Dim name As String = _ section.SectionInformation.Name Console.WriteLine("Name: {0}", name) Next End Sub
Available since 2.0
