System.Configuration.ConfigurationSectionGroup.ForceDeclaration 方法 (Boolean)

方法描述

强制声明此 ConfigurationSectionGroup 对象。

语法定义(C# System.Configuration.ConfigurationSectionGroup.ForceDeclaration 方法 (Boolean) 的用法)

public void ForceDeclaration(
	bool force
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
force System-Boolean 如果必须将 ConfigurationSectionGroup 对象写入文件,则为 true;否则为 false。
返回值 void

提示和注释

如果 force 为 true,则可通过 ForceDeclaration 方法将此 ConfigurationSectionGroup 声明强制写入文件。 如果 force 为 false,并且系统需要 ConfigurationSectionGroup 对象,则此操作可能被忽略。

即使不需要 ConfigurationSectionGroup 对象(由于已经在父文件中进行声明),也可通过 ForceDeclaration 方法将它强制写入配置文件。 另外,不需要某个组时,它还可以从配置文件中移除该组。

有时可能会希望使用 ForceDeclaration 方法以使配置文件在不同的计算机之间具有更好的可移植性,而不必担心该组声明是否已经存在。

System.Configuration.ConfigurationSectionGroup.ForceDeclaration 方法 (Boolean)例子

下面的代码示例演示如何使用 ForceDeclaration 方法。

static void ForceDeclaration(
    ConfigurationSectionGroup sectionGroup,
    bool force)
{
    sectionGroup.ForceDeclaration(force);

    Console.WriteLine(
        "Forced declaration for the group: {0} is {1}",
        sectionGroup.Name, force.ToString());
}

异常

异常 异常描述
InvalidOperationException
  • ConfigurationSectionGroup 对象是根节组。
  • ConfigurationSectionGroup 对象包含位置。

命名空间

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