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

方法描述

强制关联的配置节出现在配置文件中，或者从配置文件中移除现有节。

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

public void ForceDeclaration(
	bool force
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
force System-Boolean 如果应将关联的节写入配置文件，则为 true；否则为 false。
返回值 void

提示和注释

如果 force 为 true，则 ForceDeclaration 方法强制将此 SectionInformation 声明写入配置文件。 如果 force 为 false，并且系统需要 SectionInformation 声明，则此操作可能被忽略。

注意

即使因为该节已经在父文件中声明而不再需要，也可以通过 ForceDeclaration 方法将 SectionInformation 声明强制写入配置文件。 使用 ForceDeclaration 方法可使配置文件在不同的计算机之间具有更好的可移植性。 还可以确保即使您对父配置文件没有控制权，该节仍将存在。

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

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

// Force the section information to be written to
// the configuration file.
section.SectionInformation.ForceDeclaration(true);

异常

异常 异常描述
ConfigurationErrorsException force 为 true，且关联的节无法导出到子配置文件，或者该节未声明。

命名空间

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

相关资源

SectionInformation 类
ForceDeclaration 重载
System.Configuration 命名空间
IsDeclarationRequired
MSDN