<linkedConfiguration> 要素

インクルードする構成ファイルを指定します。

<linkedConfiguration
   href="URL of linked configuration file"/>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性	説明
href	インクルードされる構成ファイルの URL です。 href 属性に指定できる形式は "file://" に限られています。 ローカル ファイルと UNC ファイルがサポートされています。

子要素

なし。

親要素

要素	説明
<configuration> の <assemblyBinding> 要素	構成レベルでのアセンブリ バインディング ポリシーを指定します。

解説

<linkedConfiguration> 要素は、コンポーネント アセンブリの供給を簡素化します。 既知の場所に構成ファイルがあるアセンブリを 1 つまたは複数のアプリケーションが使用する場合は、それらのアプリケーションの構成ファイルに、構成情報を直接取り込むのではなく、<linkedConfiguration> 要素を使用してアセンブリ構成ファイルをインクルードできます。 コンポーネント アセンブリが供給される場合は、共通の構成ファイルを更新することで、そのアセンブリを使用するすべてのアプリケーションに更新された構成情報が提供されます。

メモ
Windows side-by-side マニフェストを使用するアプリケーションに対しては、<linkedConfiguration> 要素がサポートされません。

リンクされた構成ファイルの使用については、次の規則が適用されます。

• インクルードされる構成ファイル内の設定は、ローダー バインディング ポリシーにのみ影響し、ローダーのみが使用します。 インクルードされる構成ファイルには、バインディング ポリシー以外の設定も指定できますが、それらの設定には効力がありません。

• href 属性に指定できる形式は "file://" に限られています。 ローカル ファイルと UNC ファイルがサポートされています。

• 構成ファイルあたりのリンクされる構成の数には制限がありません。

• リンクされるすべての構成ファイルは、マージされて 1 つのファイルとなります。これは、C/C++ の #include ディレクティブの動作と似ています。

• <linkedConfiguration> 要素は、アプリケーション構成ファイルでのみ使用でき、Machine.config では無視されます。

• 循環参照は、検出されて終了されます。 つまり、一連の構成ファイルの <linkedConfiguration> 要素がループを生成する場合は、そのループが検出されて停止されます。

使用例

ローカル ハード ディスクから構成ファイルをインクルードする方法を、次のコード例に示します。

<configuration>
   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <linkedConfiguration href="file://c:\Program Files\Contoso\sharedConfig.xml"/>
   </assemblyBinding>
</configuration>

参照

参照

<configuration> の <assemblyBinding> 要素

その他の技術情報

.NET Framework の構成ファイル スキーマ