System.Configuration.ConfigurationManager 类

方法描述

提供对客户端应用程序配置文件的访问。 此类不能被继承。

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

public static class ConfigurationManager

构造函数

构造函数名称 构造函数描述

成员/方法

方法名称 方法描述
GetSection 检索当前应用程序默认配置的指定配置节。
OpenExeConfiguration(ConfigurationUserLevel) 将当前应用程序的配置文件作为 Configuration 对象打开。
OpenExeConfiguration(String) 将指定的客户端配置文件作为 Configuration 对象打开。
OpenMachineConfiguration 将当前计算机上的计算机配置文件作为 Configuration 对象打开。
OpenMappedExeConfiguration 可将指定的客户端配置文件作为使用指定文件映射和用户级别的 Configuration 对象打开。
OpenMappedMachineConfiguration 将计算机配置文件作为使用指定文件映射的 Configuration 对象打开。
RefreshSection 刷新命名节,这样在下次检索它时将从磁盘重新读取它。

提示和注释

使用 ConfigurationManager 类,可以访问计算机、应用程序和用户的配置信息。 此类替换已被否决的 ConfigurationSettings 类。

注意

应用程序配置文件的名称和位置取决于应用程序的主机。 有关更多信息,请参见 Application Configuration Files。

可以使用内置的 System.Configuration 类型或从它们派生以处理配置信息。 通过使用这些类型,可以直接处理配置信息,且能对配置文件进行扩展以包括自定义信息。

ConfigurationManager 类包括可用来执行以下任务的成员:

从配置文件中读取一个节。 若要访问配置信息,请调用 GetSection 方法。 对于某些节,例如 appSettings 和 connectionStrings,请使用 AppSettings 和 ConnectionStrings 类。 这些成员执行只读操作,使用配置的单个缓存实例,并且可识别多线程。

将配置文件作为一个整体进行读取和写入。 应用程序能够读写任何级别的配置设置,不管是自己的还是其他应用程序或计算机的,也不管是本地的还是远程的。 使用 ConfigurationManager 类提供的方法之一,可打开配置文件,例如 SampleApp.exe.config。 这些方法返回一个 Configuration 对象,该对象进而公开您可以用来处理关联配置文件的方法和属性。 这些方法执行读取或写入操作,并于每次写入文件时创建配置数据。

支持配置任务。 下列类型用于支持各种配置任务:

SectionInformation

PropertyInformation

PropertyInformationCollection

ElementInformation

ContextInformation

ConfigurationSectionGroup

ConfigurationSectionGroupCollection

除了处理现有的配置信息外,还可以通过扩展内置的配置类型(如 ConfigurationElement、ConfigurationElementCollection、ConfigurationProperty 和 ConfigurationSection 类),来创建和处理自定义配置元素。 有关如何以编程方式扩展内置配置类型的示例,请参见 ConfigurationSection。 有关如何扩展内置配置类型(该内置配置类型使用基于特性的模型)的示例,请参见 ConfigurationElement。

对实现者的说明

Configuration 类允许进行编程访问以编辑配置文件。 使用 ConfigurationManager 提供的 Open 方法中的一种。 这些方法返回一个 Configuration 对象,该对象又提供处理基础配置文件所需的方法和属性。 您可以访问这些文件以进行读取或写入。

若要读取配置文件,请使用 GetSection 或 GetSectionGroup 读取配置信息。 进行读取的用户或过程必须具有下面的权限:

在当前配置层次结构级别下对配置文件的读取权限。

对所有父级配置文件进行读取的权限。

如果应用程序需要对它自己的配置进行只读访问,我们建议使用 GetSection 方法。 此方法提供对当前应用程序的缓存配置值的访问,它的性能比 Configuration 类更好。

若要写入配置文件,请使用 Save 方法中的一种。 进行写入的用户或进程必须具有下面的权限:

对配置层次结构中当前级别的配置文件和目录的写入权限。

对所有配置文件的读取权限。

System.Configuration.ConfigurationManager 类例子

这些元素是在您首次运行该示例时生成的。



    
        

继承层次结构

System.Object

System.Configuration.ConfigurationManager

命名空间

namespace: System.Configuration

程序集: System.Configuration(在 System.Configuration.dll 中)

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.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 系统要求。