System.Configuration.ConfigurationManager.OpenMachineConfiguration 方法

方法描述

将当前计算机上的计算机配置文件作为 Configuration 对象打开。

语法定义(C# System.Configuration.ConfigurationManager.OpenMachineConfiguration 方法 的用法)

public static Configuration OpenMachineConfiguration()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 System.Configuration.Configuration 一个 Configuration 对象。

提示和注释

除非为本地应用程序重写，否则计算机配置设置将应用于整台计算机和驻留在其上的所有应用程序。 计算机配置设置是从当前运行的 .NET Framework 版本的 Machine.config 文件中读取的。 Machine.config 文件位于下面的子目录中：

%windir%\Microsoft.NET\Framework\版本\config

注意

若要获取资源的 Configuration 对象，您的代码必须对它从中继承设置的所有配置文件具有读权限。 若要更新配置文件，您的代码还必须对该配置文件及其所在目录具有写权限。 无法访问计算机中安装的其他版本的 .NET Framework 的 Machine.config 文件。

System.Configuration.ConfigurationManager.OpenMachineConfiguration 方法例子

下面的代码示例演示如何使用 OpenMachineConfiguration 方法获取配置文件中包含的所有节。

// Access the machine configuration file using mapping.
   // The function uses the OpenMappedMachineConfiguration 
   // method to access the machine configuration. 
   public static void MapMachineConfiguration()
   {
     // Get the machine.config file.
     Configuration machineConfig =
       ConfigurationManager.OpenMachineConfiguration();
     // Get the machine.config file path.
     ConfigurationFileMap configFile =
       new ConfigurationFileMap(machineConfig.FilePath);

     // Map the application configuration file to the machine 
     // configuration file.
     Configuration config =
       ConfigurationManager.OpenMappedMachineConfiguration(
         configFile);

     // Get the AppSettings section.
     AppSettingsSection appSettingSection =
       (AppSettingsSection)config.GetSection("appSettings");
     appSettingSection.SectionInformation.AllowExeDefinition =
         ConfigurationAllowExeDefinition.MachineToRoamingUser;

     // Display the configuration file sections.
     ConfigurationSectionCollection sections = 
       config.Sections;

     Console.WriteLine();
     Console.WriteLine("Using OpenMappedMachineConfiguration.");
     Console.WriteLine("Sections in machine.config:");

     // Get the sections in the machine.config.
     foreach (ConfigurationSection section in sections)
     {
         string name = section.SectionInformation.Name;
         Console.WriteLine("Name: {0}", name);
     }

   }

异常

异常 异常描述
ConfigurationErrorsException 未能加载配置文件。

命名空间

namespace: System.Configuration

程序集: System.Configuration（在 System.Configuration.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

相关资源

ConfigurationManager 类
System.Configuration 命名空间
Configuration
MSDN