bindingFailure MDA

[アーティクル]
05/09/2023

Note

この記事は .NET Framework に固有のものです。 .NET 6 以降のバージョンを含む、.NET の新しい実装には適用されません。

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");
        }
    }
}

次の方法で共有

bindingFailure MDA

現象

原因

解決方法

ランタイムへの影響

出力

構成

例

関連項目

その他のリソース