System.Configuration.ConfigurationManager.GetSection 方法

方法描述

检索当前应用程序默认配置的指定配置节。

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

public static Object GetSection(
	string sectionName
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
sectionName System-String 配置节的路径和名称。
返回值 System.Object 指定的 ConfigurationSection 对象，或者，如果该节不存在，则为 null。

提示和注释

对于客户端应用程序，此方法检索通过合并应用程序配置文件、本地用户配置文件和漫游配置文件而获得的最终配置文件。

GetSection 方法只能访问运行时的配置信息，不能更改这些配置信息。 若要更改配置，可通过使用下列 Open 方法中的一种来对所获得的配置文件使用 GetSection 方法：

OpenExeConfiguration

OpenMachineConfiguration

OpenMappedExeConfiguration

OpenMappedExeConfiguration

对实现者的说明

必须将返回值强制转换为期望的配置类型。 为了避免可能出现的强制转换异常，应当使用条件强制转换运算，例如 C# 中的 as 运算符或 Visual Basic 中的 TryCast 函数。

System.Configuration.ConfigurationManager.GetSection 方法例子

该示例摘自一个为 ConfigurationManager 类提供的更大的示例。

// Create the AppSettings section.
// The function uses the GetSection(string)method 
// to access the configuration section. 
// It also adds a new element to the section collection.
public static void CreateAppSettings()
{
  // Get the application configuration file.
  System.Configuration.Configuration config =
    ConfigurationManager.OpenExeConfiguration(
          ConfigurationUserLevel.None);

  string sectionName = "appSettings";

  // Add an entry to appSettings.
  int appStgCnt =
      ConfigurationManager.AppSettings.Count;
  string newKey = "NewKey" + appStgCnt.ToString();

  string newValue = DateTime.Now.ToLongDateString() + 
    " " + DateTime.Now.ToLongTimeString();

  config.AppSettings.Settings.Add(newKey, newValue);

  // Save the configuration file.
  config.Save(ConfigurationSaveMode.Modified);

  // Force a reload of the changed section. This 
  // makes the new values available for reading.
  ConfigurationManager.RefreshSection(sectionName);

  // Get the AppSettings section.
  AppSettingsSection appSettingSection =
    (AppSettingsSection)config.GetSection(sectionName);

  Console.WriteLine();
  Console.WriteLine("Using GetSection(string).");
  Console.WriteLine("AppSettings section:");
  Console.WriteLine(
    appSettingSection.SectionInformation.GetRawXml());
}

异常

异常 异常描述
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 命名空间
ConfigurationSection
MSDN