Assembly.Load メソッド

定義

名前空間:

System.Reflection

アセンブリ:

netstandard.dll, System.Runtime.dll

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

オーバーロード

名前	説明
Load(Byte[])	出力されたアセンブリを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージを使用してアセンブリを読み込みます。
Load(String)	指定した名前のアセンブリを読み込みます。
Load(AssemblyName)	AssemblyNameを指定してアセンブリを読み込みます。
Load(Byte[], Byte[])	出力されたアセンブリを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージ (必要に応じてアセンブリのシンボルを含む) を使用してアセンブリを読み込みます。

Load(Byte[])

ソース:

Assembly.cs

出力されたアセンブリを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージを使用してアセンブリを読み込みます。

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
public static System.Reflection.Assembly Load(byte[] rawAssembly);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
static member Load : byte[] -> System.Reflection.Assembly

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

パラメーター

rawAssembly

Byte[]

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

戻り値

Assembly

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

属性

RequiresUnreferencedCodeAttribute

例外

ArgumentNullException

rawAssembly は nullです。

BadImageFormatException

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

注釈

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

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

Load(String)

ソース:

Assembly.CoreCLR.cs

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

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 は長さ 0 の文字列です。

FileNotFoundException

assemblyString が見つかりません。

FileLoadException

見つかったファイルを読み込めませんでした。

BadImageFormatException

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

例

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

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

注釈

.NET Core/.NET 5 以降では、ターゲット アセンブリは現在の AssemblyLoadContext に読み込まれ、設定されている場合は AssemblyLoadContext.CurrentContextualReflectionContext コンテキストに読み込まれます。 アセンブリの読み込みの詳細については、「 マネージド アセンブリ読み込みアルゴリズム」を参照してください。

適切なアセンブリを読み込むには、アセンブリ名の長い形式を渡して 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)

ソース:

Assembly.CoreCLR.cs

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

見つかったファイルを読み込めませんでした。

-又は-

.NET Framework のみ: 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

注釈

.NET Core/.NET 5 以降では、ターゲット アセンブリは現在の AssemblyLoadContext に読み込まれ、設定されている場合は AssemblyLoadContext.CurrentContextualReflectionContext コンテキストに読み込まれます。 アセンブリの読み込みの詳細については、「 マネージド アセンブリ読み込みアルゴリズム」を参照してください。

注

.NET Framework のみ: リモートの場所からアセンブリを読み込む方法については、 <loadFromRemoteSources>を参照してください。

注

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

注

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

こちらもご覧ください

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

Load(Byte[], Byte[])

ソース:

Assembly.cs

出力されたアセンブリを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージ (必要に応じてアセンブリのシンボルを含む) を使用してアセンブリを読み込みます。

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
public static System.Reflection.Assembly Load(byte[] rawAssembly, byte[]? rawSymbolStore);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
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

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

属性

RequiresUnreferencedCodeAttribute

例外

ArgumentNullException

rawAssembly は nullです。

BadImageFormatException

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

注釈

.NET Core/5 以降では、ターゲット アセンブリは現在の AssemblyLoadContextに読み込まれます。 アセンブリの読み込みの詳細については、「 マネージド アセンブリ読み込みアルゴリズム」を参照してください。

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

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