_AppDomain.AssemblyResolve

.NET Framework クラス ライブラリ リファレンス

AppDomain.AssemblyResolve イベント

アセンブリの解決が失敗したときに発生します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Event AssemblyResolve As
 ResolveEventHandler

Visual Basic (使用法)

Dim instance As AppDomain
Dim handler As ResolveEventHandler

AddHandler instance.AssemblyResolve, handler

C#

public event ResolveEventHandler AssemblyResolve

C++

public:
virtual event ResolveEventHandler^ AssemblyResolve {
    void add (ResolveEventHandler^ value) sealed;
    void remove (ResolveEventHandler^ value) sealed;
}

J#

/** @event */
public final void add_AssemblyResolve (ResolveEventHandler
 value)

/** @event */
public final void remove_AssemblyResolve (ResolveEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントの ResolveEventHandler で、型、アセンブリ、またはリソースを解決するアセンブリを返す必要があります。

このイベントのイベント ハンドラを登録するには、適切なアクセス許可が必要です。アクセス許可がないと、SecurityException がスローされます。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

AssemblyResolve イベントのサンプルを次に示します。

このコード例を実行するには、アセンブリの完全限定名を指定する必要があります。アセンブリの完全限定名を取得する方法については、「アセンブリ名」を参照してください。

Visual Basic

Public Class MyType
   
   Public Sub New()
      Console.WriteLine("MyType instantiated!")
   End Sub 'New

End Class 'MyType

Module Test
   
   Sub Main()
      Dim currentDomain As AppDomain = AppDomain.CurrentDomain
      
      InstantiateMyType(currentDomain)    ' Failed!

      AddHandler currentDomain.AssemblyResolve, AddressOf
 MyResolveEventHandler
      
      InstantiateMyType(currentDomain)    ' OK!
   End Sub 'Main
   
   Sub InstantiateMyType(domain As AppDomain)
      Try
     ' You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture,
 PublicKeyToken", "MyType")
      Catch e As Exception
         Console.WriteLine(e.Message)
      End Try
   End Sub 'InstantiateMyType
   
   Function MyResolveEventHandler(sender As
 Object, args As ResolveEventArgs) As
 [Assembly]
      Console.WriteLine("Resolving...")
      Return GetType(MyType).Assembly
   End Function 'MyResolveEventHandler

End Module 'Test

C#

public class MyType {
   public MyType() {
      Console.WriteLine("MyType instantiated!");
   }
}

class Test {
   public static void Main()
 {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyType(currentDomain);    // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyType(currentDomain);    // OK!
   }

   static void InstantiateMyType(AppDomain
 domain) {
      try {
     // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken",
 "MyType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }
   
   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs
 args) {
      Console.WriteLine("Resolving...");
      return typeof(MyType).Assembly;
   }
}

C++

public ref class MyType
{
public:
   MyType()
   {
      Console::WriteLine( "MyType instantiated!" );
   }

};

ref class Test
{
public:
   static void InstantiateMyType( AppDomain^
 domain )
   {
      try
      {
         // You must supply a valid fully qualified assembly name here.
         domain->CreateInstance( "Assembly text name, Version, Culture, PublicKeyToken",
 "MyType" );
      }
      catch ( Exception^ e ) 
      {
         Console::WriteLine( e->Message );
      }
   }

   static Assembly^ MyResolveEventHandler( Object^ sender, ResolveEventArgs^
 args )
   {
      Console::WriteLine( "Resolving..." );
      return MyType::typeid->Assembly;
   }
};

int main()
{
   AppDomain^ currentDomain = AppDomain::CurrentDomain;
   Test::InstantiateMyType( currentDomain ); // Failed!
   currentDomain->AssemblyResolve += gcnew ResolveEventHandler( Test::MyResolveEventHandler
 );
   Test::InstantiateMyType( currentDomain ); // OK!
}

.NET Framework のセキュリティ

• SecurityPermission  (このイベントのイベント ハンドラを追加するために必要なアクセス許可)。SecurityPermissionFlag.ControlAppDomain (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
AppDomain クラス
AppDomain メンバ
System 名前空間

_AppDomain.AssemblyResolve イベント

COM オブジェクトに、AppDomain.AssemblyResolve イベントへのバージョンに依存しないアクセスが用意されています。

このイベントは、CLS に準拠していません。  

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Event AssemblyResolve As ResolveEventHandler

Visual Basic (使用法)

Dim instance As _AppDomain
Dim handler As ResolveEventHandler

AddHandler instance.AssemblyResolve, handler

C#

event ResolveEventHandler AssemblyResolve

C++

event ResolveEventHandler^ AssemblyResolve {
    void add (ResolveEventHandler^ value);
    void remove (ResolveEventHandler^ value);
}

J#

/** @event */
void add_AssemblyResolve (ResolveEventHandler value)

/** @event */
void remove_AssemblyResolve (ResolveEventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

詳細については、AppDomain.AssemblyResolve イベントのトピックを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
_AppDomain インターフェイス
_AppDomain メンバ
System 名前空間