SectionInformation.ConfigSource 属性

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

SectionInformation.cs

获取或设置包含文件的名称，关联配置节在其中定义（如果存在这样一个文件）。

public:
 property System::String ^ ConfigSource { System::String ^ get(); void set(System::String ^ value); };

public string ConfigSource { get; set; }

member this.ConfigSource : string with get, set

Public Property ConfigSource As String

属性值

String

包含文件的名称，关联的 ConfigurationSection 在其中定义（如果存在这样一个文件）；否则为空字符串 ("")。

注解

属性ConfigSource表示为ConfigurationSection与 对象关联的 SectionInformation 对象指定的 特性的值configSource。

ConfigurationSection实现可以选择性地指定一个单独的文件，其中定义了该节的配置设置。 这在多种方式中非常有用：

• 使用包含文件可能会导致配置文件的逻辑和模块化结构。

• 文件访问安全性和权限可用于限制对配置设置部分的访问。

• 可以修改和重新加载包含文件中未在应用程序初始化期间使用的设置，而无需重启应用程序。

以下示例演示如何在配置文件中使用此属性来指定 pages 节在外部包含文件中定义：

<pages configSource="pages.config"/>

如果配置包含文件中的任何设置要求应用程序在修改时重启它们，请将 属性 RestartOnExternalChanges 设置为 true。

在 ASP.NET 应用程序中，可以在运行时向 ConfigSource 属性分配备用配置文件的名称。 在这种情况下，Web.config 文件中包含的默认连接字符串信息将覆盖文件的内容。 当备用文件不存在并且是在运行时创建的时，也会发生这种情况。 如果 Web.config 文件不包含任何连接字符串信息，则会向备用文件添加一个空节。

另请参阅

• RestartOnExternalChanges