SectionInformation.ConfigSource プロパティ

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

ソース:

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 プロパティは、SectionInformation オブジェクトに関連付けられているConfigurationSection オブジェクトに指定されたconfigSource属性の値を表します。

ConfigurationSection実装では、必要に応じて、そのセクションの構成設定を定義する別のファイルを指定できます。 これは複数の方法で役立ちます。

• インクルード ファイルを使用すると、構成ファイルの論理構造とモジュール構造が増える可能性があります。

• ファイル アクセスのセキュリティとアクセス許可を使用して、構成設定のセクションへのアクセスを制限できます。

• アプリケーションの初期化中に使用されないインクルード ファイルの設定は、アプリケーションの再起動を必要とせずに変更および再読み込みできます。

次の例は、構成ファイルでこの属性を使用して、外部インクルード ファイルで pages セクションを定義することを指定する方法を示しています。

<pages configSource="pages.config"/>

構成インクルード ファイルのいずれかの設定で、変更時にアプリケーションを再起動する必要がある場合は、 RestartOnExternalChanges プロパティを true に設定します。

ASP.NET アプリケーションでは、実行時に、代替構成ファイルの名前を ConfigSource プロパティに割り当てることができます。 その場合、ファイルの内容は、Web.config ファイルに含まれる既定の接続文字列情報によって上書きされます。 これは、代替ファイルが存在せず、実行時に作成される場合にも発生します。 Web.config ファイルに接続文字列情報が含まれていない場合は、空のセクションが代替ファイルに追加されます。

こちらもご覧ください

• RestartOnExternalChanges