bindingFailure MDA

bindingFailure マネージド デバッグ アシスタント (MDA) は、アセンブリの読み込みに失敗したときにアクティブになります。

現象

コードは、静的参照またはいずれかのローダー メソッド (Assembly.Load や Assembly.LoadFrom など) を使用して、アセンブリを読み込もうとしました。 アセンブリは読み込まれず、FileNotFoundException または FileLoadException 例外がスローされました。

原因

バインディング エラーは、ランタイムがアセンブリを読み込むことができない場合に発生します。 バインディング エラーは、次のいずれかの状況の結果として発生することもあります。

• 共通言語ランタイム (CLR) は、要求されたアセンブリを見つけることができません。 考えられる理由は多数あります。たとえば、アセンブリがインストールされていない、あるいはアプリケーションがアセンブリを見つけるように正しく構成されていないなどです。

• 一般的な問題のシナリオの場合、型は別のアプリケーション ドメインに渡されます。CLR は、他のアプリケーション ドメインにその型が含まれているアセンブリを読み込む必要があります。 他のアプリケーション ドメインが元のアプリケーション ドメインとは異なる構成の場合、ランタイムがアセンブリを読み込めないことがあります。 たとえば、2 つのアプリケーション ドメインで、BaseDirectory プロパティ値が異なる可能性があります。

• 要求されたアセンブリは、破損しているか、アセンブリではありません。

• アセンブリを読み込もうとしているコードには、アセンブリを読み込むための適切なコード アクセス セキュリティのアクセス許可が指定されていません。

• ユーザー資格情報には、ファイルを読み取るために必要なアクセス許可が指定されていません。

解決方法

最初の手順は、要求されたアセンブリに CLR がバインドできなかった原因を特定することです。 たとえば、「原因」セクションに一覧表示されたシナリオのように、ランタイムが要求されたアセンブリを見つけられなかったり、読み込めなかったりする理由は多数あります。 バインディング エラーの原因を除去するには、次のアクションをお勧めします。

• bindingFailure MDA によって提供されるデータを使用して、原因を特定します。

  • アセンブリ バインダーによって生成されるエラー ログを読み取るために、Fuslogvw.exe (アセンブリ バインディング ログ ビューアー) を実行します。

  • アセンブリが要求された位置にあるかどうかを確認します。 LoadFrom および LoadFile メソッドの場合は、要求された位置を簡単に確認できます。 Load メソッドの場合は、アセンブリ ID を使用してバインドするため、アプリケーション ドメインの BaseDirectory プロパティ プローブ パスおよびグローバル アセンブリ キャッシュで、アセンブリ ID と一致するアセンブリを検索する必要があります。

• 前の手順で確認した内容に基づいて、原因を解決します。 使用できる解決オプションは、次のとおりです。

  • 要求されたアセンブリをグローバル アセンブリ キャッシュにインストールし、 Load メソッドを呼び出して ID でアセンブリを読み込みます。

  • 要求されたアセンブリをアプリケーション ディレクトリにコピーし、Load メソッドを呼び出して ID でアセンブリを読み込みます。

  • BaseDirectory プロパティを変更するか、プライベート プローブ パスを追加して、バインディング エラーが発生したアプリケーション ドメインがアセンブリ パスを含むように再構成します。

  • ログオンしているユーザーがファイルを読み取れるように、ファイルのアクセス制御リストを変更します。

ランタイムへの影響

この MDA は CLR に影響しません。 バインディング エラーに関するデータを報告するだけです。

出力

MDA は、読み込みに失敗したアセンブリを報告します。これには、要求されたパスや表示名、バインディング コンテキスト、読み込みが要求されたアプリケーション ドメイン、エラーの理由などが含まれます。

表示名や要求されたパスは、そのデータが CLR で利用できなかった場合は空白である場合があります。 失敗した呼び出しが Load メソッドに対するものであった場合は、ランタイムがアセンブリの表示名を判別できなかったことが考えられます。

構成

<mdaConfig>
  <assistants>
    <bindingFailure />
  </assistants>
</mdaConfig>

例

次のコードの例は、この MDA がアクティブ化されることのある状況を示しています。

using System;
using System.Collections.Generic;
using System.Text;
using System.Reflection;
namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            // This call attempts to load a nonexistent assembly.
            // The call will throw a System.IO.FileNotFound exception
            // and cause the activation of the bindingFailure MDA
            // if it is registered.
            Assembly.Load("NonExistentAssembly");
        }
    }
}

関連項目

• マネージド デバッグ アシスタントによるエラーの診断