Assembly.Load メソッド

定義

名前空間:

System.Reflection

アセンブリ:

System.Runtime.dll

アセンブリを読み込みます。

オーバーロード

Load(Byte[])	生成されたアセンブリを含む COFF (Common Object File Format) ベースのイメージを使用して、アセンブリを読み込みます。
Load(String)	指定した名前でアセンブリを読み込みます。
Load(AssemblyName)	AssemblyName を指定してアセンブリを読み込みます。
Load(Byte[], Byte[])	生成されたアセンブリが含まれている COFF ベースのイメージを使用して、このアセンブリを読み込みます。アセンブリのシンボルを含めることもできます。

Load(Byte[])

生成されたアセンブリを含む COFF (Common Object File Format) ベースのイメージを使用して、アセンブリを読み込みます。

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly);

public static System.Reflection.Assembly Load (byte[] rawAssembly);

static member Load : byte[] -> System.Reflection.Assembly

Public Shared Function Load (rawAssembly As Byte()) As Assembly

パラメーター

rawAssembly

Byte[]

生成されたアセンブリを含む COFF ベースのイメージであるバイト配列。

戻り値

Assembly

読み込まれるアセンブリ。

例外

ArgumentNullException

rawAssembly は null です。

BadImageFormatException

rawAssembly は、現在読み込まれているランタイムの有効なアセンブリではありません。

注釈

このメソッド オーバーロードは、常に、独自の分離された読み込みコンテキストで新しい Assembly オブジェクトを作成します。

.NET Frameworkのみ: このメソッドを使用して読み込まれるアセンブリの信頼レベルは、呼び出し元アセンブリの信頼レベルと同じです。 アプリケーション ドメインの信頼レベルを持つバイト配列からアセンブリを読み込むには、 メソッドのオーバーロードを使用します Load(Byte[], Byte[], SecurityContextSource) 。 バイト配列を受け取るメソッドのオーバーロードで証拠を Load 使用する方法の詳細については、 メソッドのオーバーロードに関するページを Load(Byte[], Byte[], Evidence) 参照してください。

Load(String)

指定した名前でアセンブリを読み込みます。

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString);

public static System.Reflection.Assembly Load (string assemblyString);

static member Load : string -> System.Reflection.Assembly

Public Shared Function Load (assemblyString As String) As Assembly

パラメーター

assemblyString

String

アセンブリ名の長い形式または短い形式です。

戻り値

Assembly

読み込まれるアセンブリ。

例外

ArgumentNullException

assemblyString が nullです。

ArgumentException

assemblyString は長さゼロの文字列です。

FileNotFoundException

assemblyString が見つかりません。

FileLoadException

検出されたファイルを読み込めませんでした。

BadImageFormatException

assemblyString は、現在読み込まれているランタイムの有効なアセンブリではありません。

例

次の例では、完全修飾名を指定してアセンブリを読み込み、指定したアセンブリに含まれるすべての型を一覧表示します。 完全修飾アセンブリ名を取得する方法については、「アセンブリ 名」を参照してください。

using namespace System;
using namespace System::Collections;
using namespace System::Reflection;
int main()
{
    // You must supply a valid fully qualified assembly name.            
    Assembly^ SampleAssembly = Assembly::Load
        ( "SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3" );
    array<Type^>^ Types = SampleAssembly->GetTypes();
    
    // Display all the types contained in the specified assembly.
    IEnumerator^ myEnum = Types->GetEnumerator();
    Type^ oType;
    while ( myEnum->MoveNext() )
    {
        oType = safe_cast<Type^>(myEnum->Current);
        Console::WriteLine( oType->Name );
    }
}

using System;
using System.Reflection;

class Class1
{
    public static void Main()
    {
        // You must supply a valid fully qualified assembly name.
        Assembly SampleAssembly = Assembly.Load
            ("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3");
        // Display all the types contained in the specified assembly.
        foreach (Type oType in SampleAssembly.GetTypes()) {
            Console.WriteLine(oType.Name);
        }
    }
}

Imports System.Reflection

Class Class1
    Public Shared Sub Main()
        ' You must supply a valid fully qualified assembly name.            
        Dim SampleAssembly As [Assembly] = _
            [Assembly].Load("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3")
        Dim oType As Type
        ' Display all the types contained in the specified assembly.
        For Each oType In SampleAssembly.GetTypes()
            Console.WriteLine(oType.Name)
        Next oType
    End Sub	'LoadSample
End Class

注釈

適切なアセンブリを読み込むには、アセンブリ名の長い形式を Load 渡して メソッドを呼び出すことをお勧めします。 アセンブリ名の長い形式は、その単純な名前 (System.dll アセンブリの "System" など) とそのバージョン、カルチャ、公開キー トークン、および必要に応じてプロセッサ アーキテクチャで構成されます。 アセンブリ FullName の プロパティに対応します。 次の例は、長い名前を使用して、.NET Framework 4 の System.dll アセンブリを読み込む方法を示しています。

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      string longName = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089";
      Assembly assem = Assembly.Load(longName);
      if (assem == null)
         Console.WriteLine("Unable to load assembly...");
      else
         Console.WriteLine(assem.FullName);
   }
}
// The example displays the following output:
//        system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

Imports System.Reflection

Module Example
   Public Sub Main()
      Dim longName As String = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
      Dim assem As Assembly = Assembly.Load(longName)
      If assem Is Nothing Then
         Console.WriteLine("Unable to load assembly...")
      Else
         Console.WriteLine(assem.FullName)
      End If
   End Sub
End Module
' The example displays the following output:
'       system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

FileLoadException は、完全なアセンブリ名を指定し、単純な名前に一致する最初のアセンブリのバージョン、カルチャ、または公開キー トークンが異なる場合 assemblyString にスローされます。 ローダーは、単純な名前に一致する他のアセンブリのプローブを続行しません。

.NET Framework バージョン 2.0 では、プロセッサ アーキテクチャがアセンブリ ID に追加され、アセンブリ名文字列の一部として指定できます。 たとえば、"ProcessorArchitecture=msil" とします。 ただし、アセンブリ名を指定する推奨される方法は、オブジェクトを AssemblyName 作成し、それを メソッドの Load 適切なオーバーロードに渡すことです。 以下を参照してください。AssemblyName.ProcessorArchitecture

こちらもご覧ください

• AssemblyName
• LoadFrom(String)
• ランタイムがアセンブリを検索する方法

Load(AssemblyName)

AssemblyName を指定してアセンブリを読み込みます。

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef);

public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef);

static member Load : System.Reflection.AssemblyName -> System.Reflection.Assembly

Public Shared Function Load (assemblyRef As AssemblyName) As Assembly

パラメーター

assemblyRef

AssemblyName

読み込むアセンブリを記述するオブジェクト。

戻り値

Assembly

読み込まれるアセンブリ。

例外

ArgumentNullException

assemblyRef が nullです。

FileNotFoundException

assemblyRef が見つかりません。

FileLoadException

検出されたファイルを読み込めませんでした。

- または -

assemblyRef でリモート アセンブリが指定されていますが、リモート アセンブリ内でコードを実行する機能が無効になっています。 <loadFromRemoteSources> を参照してください。

注: .NET for Windows ストア アプリ または ポータブル クラス ライブラリでは、代わりに基底クラスの例外 IOExceptionをキャッチします。

BadImageFormatException

assemblyRef は、現在読み込まれているランタイムの有効なアセンブリではありません。

例

次の例では、 オブジェクトを AssemblyName インスタンス化し、それを使用してアセンブリを sysglobal.dll 読み込みます。 次に、アセンブリのパブリック型の完全な名前を表示します。

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      String fullName = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                        "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL";
      var an = new AssemblyName(fullName);
      var assem = Assembly.Load(an);
      Console.WriteLine("Public types in assembly {0}:", assem.FullName);
      foreach (var t in assem.GetTypes())
         if (t.IsPublic)
            Console.WriteLine("   {0}", t.FullName);
   }
}
// The example displays the following output:
//   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
//      System.Globalization.CultureAndRegionInfoBuilder
//      System.Globalization.CultureAndRegionModifiers

Imports System.Reflection

Module Example
   Public Sub Main()
      Dim fullName As String = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                               "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL"
      Dim an As New AssemblyName(fullName)
      Dim assem As Assembly = Assembly.Load(an)
      Console.WriteLine("Public types in assembly {0}:", assem.FullName)
      For Each t As Type in assem.GetTypes()
         If t.IsPublic Then Console.WriteLine("   {0}", t.FullName)
      Next
   End Sub
End Module
' The example displays the following output:
'   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
'      System.Globalization.CultureAndRegionInfoBuilder
'      System.Globalization.CultureAndRegionModifiers

注釈

FileLoadException 完全なアセンブリ名を指定し、単純な名前に一致する最初のアセンブリのバージョン、カルチャ、または公開キー トークンが異なる場合 assemblyRef は、 がスローされます。 ローダーは、単純な名前に一致する他のアセンブリのプローブを続行しません。 .NET Framework 4 以降では、リモート アセンブリでのコードの実行が既定で無効になっているため、 FileLoadException がリモート アセンブリを指定している場合assemblyRefも がスローされます。 リモートの場所から読み込まれたコードの実行を有効にするには、 構成要素を <loadFromRemoteSources> 使用できます。

注意

プロパティ セットのみで をAssemblyNameCodeBase使用しないでください。 プロパティは CodeBase アセンブリ ID の要素 (名前やバージョンなど) を提供しないため、読み込み規則に従って読み込みが行われることはありません。これは、 メソッドで Load 想定されるとおりです。 代わりに、読み込み元ルールを使用してアセンブリが読み込まれます。 読み込み元コンテキストを使用する場合の欠点については、メソッドの Assembly.LoadFrom オーバーロードまたは アセンブリ読み込みのベスト プラクティスに関するページを参照してください。

注意

プロパティと プロパティのAssemblyName.NameAssemblyName.CodeBase両方が設定されている場合、アセンブリを読み込もうとする最初の試行では、表示名 (バージョン、カルチャなどを含む) がプロパティによってAssembly.FullName返されます。 ファイルが見つからない場合は、 CodeBase を使用してアセンブリを検索します。 を使用して CodeBaseアセンブリが見つかった場合、表示名はアセンブリと一致します。 一致が失敗すると、 FileLoadException がスローされます。

こちらもご覧ください

• AssemblyName
• ランタイムがアセンブリを検索する方法

Load(Byte[], Byte[])

生成されたアセンブリが含まれている COFF ベースのイメージを使用して、このアセンブリを読み込みます。アセンブリのシンボルを含めることもできます。

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore);

public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[]? rawSymbolStore);

static member Load : byte[] * byte[] -> System.Reflection.Assembly

Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte()) As Assembly

パラメーター

rawAssembly

Byte[]

生成されたアセンブリを含む COFF ベースのイメージであるバイト配列。

rawSymbolStore

Byte[]

アセンブリのシンボルを表す生バイトを格納するバイト配列。

戻り値

Assembly

読み込まれるアセンブリ。

例外

ArgumentNullException

rawAssembly は null です。

BadImageFormatException

rawAssembly は、現在読み込まれているランタイムの有効なアセンブリではありません。

注釈

このメソッド オーバーロードは、常に、独自の分離された読み込みコンテキストで新しい Assembly オブジェクトを作成します。

.NET Frameworkのみ: このメソッドを使用して読み込まれるアセンブリの信頼レベルは、呼び出し元アセンブリの信頼レベルと同じです。 アプリケーション ドメインの信頼レベルを持つバイト配列からアセンブリを読み込むには、 メソッドのオーバーロードを使用します Load(Byte[], Byte[], SecurityContextSource) 。 バイト配列を受け取るメソッドのオーバーロードで証拠を Load 使用する方法の詳細については、 メソッドのオーバーロードに関するページを Load(Byte[], Byte[], Evidence) 参照してください。