次の方法で共有


<bindingRedirect> 要素

1 つのアセンブリ バージョンを別のアセンブリ バージョンにリダイレクトします。

<構成>
   <実行中>
     <assemblyBinding>
       <従属アセンブリ>
         <bindingRedirect>

構文

   <bindingRedirect
oldVersion="existing assembly version"
newVersion="new assembly version"/>

属性および要素

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

Attributes

特性 Description
oldVersion 必須の属性。

最初に要求されたアセンブリのバージョンを指定します。 アセンブリバージョン番号の形式は major.minor.build.revision です。 このバージョン番号の各部分の有効な値は 0 から 65535 です。

次の形式でバージョンの範囲を指定することもできます。

n.n.n.n - n.n.n.n
newVersion 必須の属性。

最初に要求されたバージョンの代わりに使用するアセンブリのバージョンを、n.n.n.n という形式で指定します。

この値は、 oldVersionよりも前のバージョンを指定できます。

子要素

要素 Description
None

親要素

要素 Description
assemblyBinding アセンブリ バージョンのリダイレクトとアセンブリの場所に関する情報が含まれています。
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
dependentAssembly 各アセンブリのバインド ポリシーとアセンブリの場所をカプセル化します。 アセンブリごとに 1 つの dependentAssembly 要素を使用します。
runtime アセンブリ バインドとガベージ コレクションに関する情報が含まれています。

注釈

厳密な名前付きアセンブリに対して .NET Framework アプリケーションをビルドすると、新しいバージョンが使用可能な場合でも、アプリケーションは既定でそのバージョンのアセンブリを実行時に使用します。 ただし、新しいバージョンのアセンブリに対して実行するようにアプリケーションを構成できます。 ランタイムがこれらのファイルを使用して使用するアセンブリのバージョンを決定する方法の詳細については、「 ランタイムがアセンブリを検索する方法」を参照してください。

bindingRedirect要素に複数のdependentAssembly要素を含めることで、複数のアセンブリ バージョンをリダイレクトできます。 新しいバージョンから古いバージョンのアセンブリにリダイレクトすることもできます。

アプリケーション構成ファイル内の明示的なアセンブリ バインド リダイレクトには、セキュリティ アクセス許可が必要です。 これは、サードパーティからの .NET Framework アセンブリとアセンブリのリダイレクトに適用されます。 アクセス許可は、SecurityPermissionFlagSecurityPermission フラグを設定することによって付与されます。 詳細については、「 アセンブリ バインディング リダイレクトセキュリティアクセス許可」を参照してください。

Example

次の例は、あるアセンブリ バージョンを別のアセンブリ バージョンにリダイレクトする方法を示しています。

<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"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

こちらも参照ください