<disableCachingBindingFailures> 要素

  • [アーティクル]

プローブによってアセンブリが見つからなかったために発生するバインド エラーのキャッシュを無効にするかどうかを指定します。

configuration
  runtime
    <disableCachingBindingFailures>

構文

<disableCachingBindingFailures enabled="0|1"/>

属性および要素

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

属性

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

プローブによってアセンブリが見つからなかったために発生するバインド エラーのキャッシュを無効にするかどうかを指定します。

enabled 属性

[値] 説明
0 プローブによってアセンブリが見つからなかったために発生するバインド エラーのキャッシュを無効にしません。 これは .NET Framework バージョン 2.0 以降の既定のバインディング動作です。
1 プローブによってアセンブリが見つからなかったために発生するバインド エラーのキャッシュを無効にします。 この設定を使用すると、.NET Framework バージョン 1.1 のバインディング動作に戻ります。

子要素

なし。

親要素

要素 説明
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
runtime アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。

解説

.NET Framework バージョン 2.0 以降、アセンブリを読み込む既定の動作では、すべてのバインド エラーと読み込みエラーがキャッシュされます。 つまり、アセンブリの読み込みに失敗した場合、その後で同じアセンブリを読み込もうとする要求は、アセンブリを探すことなくすぐに失敗します。 この要素を使用すると、プローブ パスにアセンブリが見つからなかったために発生するバインド エラーの既定の動作は無効になります。 これらのエラーでは、FileNotFoundException がスローされます。

一部のバインド エラーと読み込みエラーはこの要素の影響を受けず、常にキャッシュされます。 これらのエラーは、アセンブリが見つかったが、読み込むことができなかったことが原因で発生します。 BadImageFormatException または FileLoadException がスローされます。 このようなエラーの例を次に示します。

  • ファイルを読み込もうとしても有効なアセンブリではない場合は、不適切なファイルが正しいアセンブリに置き換えられても、その後のアセンブリの読み込みは失敗します。

  • ファイル システムによってロックされているアセンブリを読み込もうとすると、ファイル システムでアセンブリが解放された後でも、その後のアセンブリの読み込みは失敗します。

  • 読み込もうとしているアセンブリの 1 つまたは複数のバージョンがプローブ パスに存在するが、要求している特定のバージョンがそれらの中にない場合は、正しいバージョンがプローブ パスに移動されても、そのバージョンを読み込もうとすると失敗します。

例

次の例では、プローブによってアセンブリが見つからなかったために発生するアセンブリ バインド エラーのキャッシュを無効にする方法を示します。

<configuration>  
   <runtime>  
      <disableCachingBindingFailures enabled="1" />  
   </runtime>  
</configuration>

関連項目