<linkedConfiguration> 要素

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

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

構文

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

属性

属性 説明
href 必須の属性です。

インクルードする構成ファイルの URL。 href 属性でサポートされている形式は file:// のみです。 ローカル ファイルと UNC ファイルがサポートされています。

親要素

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

子要素

なし

解説

<linkedConfiguration> 要素を使用すると、コンポーネント アセンブリのサービスが簡略化されます。 1 つ以上のアプリケーションが、既知の場所に存在する構成ファイルを持つアセンブリを使用する場合、構成ファイルは、構成情報を複製するのではなく、 <linkedConfiguration> 要素を使用してアセンブリ構成ファイルを含めることができます。 コンポーネント アセンブリがサービスされている場合、共通構成ファイルを更新すると、そのアセンブリを使用するすべてのアプリケーションに対して、更新された構成情報が提供されます。

Note

<linkedConfiguration> 要素は、Windows サイド バイ サイド マニフェストを使用するアプリケーションではサポートされていません。

リンクされた構成ファイルの使用は、次の規則によって制御されます。

  • インクルードされる構成ファイルの設定は、ローダー バインド ポリシーにのみ影響し、ローダーによってのみ使用されます。 インクルードされる構成ファイルには、バインド ポリシー以外の設定を含めることができますが、これらの設定は何の効果もありません。

  • href 属性でサポートされている形式は file:// のみです。 ローカル ファイルと UNC ファイルがサポートされています。

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

  • すべてのリンクされた構成ファイルは、C/C++ の #include ディレクティブの動作と同様に、1 つのアセンブリ構成ファイルを形成するためにマージされます。

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

  • 親 <assemblyBinding> 要素のスキーマに準拠している限り、含まれる構成ファイルの内容に制限はありません。

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

次の例は、ローカル ハード ドライブから構成ファイルを含める方法を示しています:

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

関連項目