<assemblyBinding> 要素

  • [アーティクル]

アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。

<configuration> 要素
  <runtime> 要素
    <assemblyBinding> 要素

<assemblyBinding  
   xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
</assemblyBinding>

属性と要素

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

属性

属性 説明

xmlns

必須属性

アセンブリのバインディングに必要な XML 名前空間を指定します。値として、文字列 "urn:schemas-microsoft-com:asm.v1" を使用します。

appliesTo

必須属性

.NET Framework アセンブリのリダイレクトを適用するランタイム バージョンを指定します。このオプションの属性では、.NET Framework バージョン番号を使用して、適用するバージョンを指定します。appliesTo 属性が指定されていない場合、<assemblyBinding> 要素は .NET Framework のすべてのバージョンに適用されます。appliesTo 属性は .NET Framework Version 1.1 で導入されました。.NET Framework Version 1.0 では無視されます。つまり、appliesTo 属性が指定されている場合でも、.NET Framework Version 1.0 を使用しているときはすべての <assemblyBinding> 要素が適用されます。

子要素

要素 説明

<dependentAssembly>

アセンブリのバインディング ポリシーとアセンブリの場所をカプセル化します。アセンブリごとに 1 つの <dependentAssembly> タグを使用します。

<probing>

アセンブリを読み込むときに、共通言語ランタイムが検索するサブディレクトリを指定します。

<publisherPolicy>

ランタイムが発行者ポリシーを適用するかどうかを指定します。

<qualifyAssembly>

部分名が使用された場合に動的に読み込む必要があるアセンブリの完全名を指定します。

親要素

要素 説明

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。

runtime

アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。

使用例

あるアセンブリ バージョンを別のバージョンにリダイレクトし、コードベースを提供する例を示します。

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <bindingRedirect oldVersion="1.0.0.0"
                             newVersion="2.0.0.0"/>
            <codeBase version="2.0.0.0"
                      href="http://www.litwareinc.com/myAssembly.dll"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

appliesTo 属性を使用して、.NET Framework アセンブリのバインディングをリダイレクトする方法の例を次に示します。

<runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
            <dependentAssembly> 
               <assemblyIdentity name="mscorcfg" publicKeyToken="b03f5f7f11d50a3a" culture=""/>
                <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="1.0.3300.0"/>
            </dependentAssembly>
       </assemblyBinding>
</runtime>

参照

関連項目

ランタイム設定スキーマ

概念

アセンブリ バージョンのリダイレクト

その他の技術情報

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