SectionInformation.ConfigSource 屬性

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

SectionInformation.cs

取得或設定關聯的組態區段定義所在的 Include 檔的名稱 (如果此檔案存在)。

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 定義所在的 Include 檔的名稱 (如果此檔案存在)，否則為空字串。

備註

屬性 ConfigSource 代表 configSource 針對 ConfigurationSection 與 SectionInformation 對象相關聯之物件所指定的屬性值。

實 ConfigurationSection 作可以選擇性地指定個別檔案，其中定義了該區段的組態設定。 這在多種方式中很有用：

• 使用 include 檔案可能會導致組態檔的更邏輯和模組化結構。

• 檔案存取安全性和許可權可用來限制對組態設定區段的存取。

• 在應用程式初始化期間未使用之 include 檔案中的設定可以修改和重載，而不需要重新啟動應用程式。

下列範例示範如何在組態檔中使用此屬性，以指定區 pages 段定義於外部 Include 檔案中：

<pages configSource="pages.config"/>

如果群組態包含檔案中的任何設定需要應用程式在修改時重新啟動，請將 RestartOnExternalChanges 屬性設定為 true。

在 ASP.NET 應用程式中，您可以在運行時間將替代組態檔的名稱指派給 ConfigSource 屬性。 在此情況下，預設會覆寫檔案的內容，連接字串 包含在 Web.config 檔案中的資訊。 這也會發生在替代檔案不存在且會在運行時間建立時發生。 如果 Web.config 檔案不包含任何 連接字串 資訊，則會將空白區段新增至替代檔案。

另請參閱

• RestartOnExternalChanges