Assembly.Load メソッド

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

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

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

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

パラメーター

返品

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

例外

注釈

アセンブリは、セキュリティ コンテキストに指定されたソースを使用して、呼び出し元のアプリケーション ドメインに読み込まれます。 rawSymbolStoreを指定した場合は、アセンブリのシンボルを表す生バイトも読み込まれます。

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

public static System.Reflection.Assembly Load(byte[] rawAssembly, byte[] rawSymbolStore, System.Security.Policy.Evidence securityEvidence);

[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load(byte[] rawAssembly, byte[] rawSymbolStore, System.Security.Policy.Evidence securityEvidence);

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

[<System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member Load : byte[] * byte[] * System.Security.Policy.Evidence -> System.Reflection.Assembly

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

パラメーター

返品

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

属性

ObsoleteAttribute

例外

注釈

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

アセンブリは、指定された証拠を使用して読み込まれます。 アセンブリのシンボルを表す生バイトも読み込まれます。

アセンブリに対して特定の権限が付与されているかどうかは、証拠に基づいています。 アセンブリとセキュリティ証拠のマージの規則は次のとおりです。

• Load パラメーターを指定しないEvidence メソッドを使用すると、ローダーが提供する証拠がアセンブリに読み込まれます。

• Load パラメーターで Evidence メソッドを使用すると、証拠の一部がマージされます。 Loadメソッドの引数として提供される証拠の一部は、ローダーによって提供される証拠の一部よりも優先されます。

• パラメーターを指定して メソッドオーバーロードを使用して COFF イメージを読み込むと、呼び出し元のアセンブリから証拠が継承されます。

• Load パラメーターとByte[]を指定して Evidence メソッドを使用して COFF イメージを読み込む場合、指定された証拠のみが使用されます。 呼び出し元アセンブリの証拠と COFF イメージの証拠は無視されます。

同じアセンブリで Load メソッドを複数回呼び出したが、異なる証拠が指定されている場合、共通言語ランタイムは、異なる証拠仕様の等価性と整合性を判断できないため、 FileLoadException をスローしません。 最初に成功する証拠は、使用される証拠です。

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString, System::Security::Policy::Evidence ^ assemblySecurity);

public static System.Reflection.Assembly Load(string assemblyString, System.Security.Policy.Evidence assemblySecurity);

[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load(string assemblyString, System.Security.Policy.Evidence assemblySecurity);

static member Load : string * System.Security.Policy.Evidence -> System.Reflection.Assembly

[<System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member Load : string * System.Security.Policy.Evidence -> System.Reflection.Assembly

Public Shared Function Load (assemblyString As String, assemblySecurity As Evidence) As Assembly

パラメーター

返品

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

属性

ObsoleteAttribute

例外

注釈

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

アセンブリに対して特定の権限が付与されているかどうかは、証拠に基づいています。 アセンブリとセキュリティ証拠のマージの規則は次のとおりです。

• Load パラメーターを指定しないEvidence メソッドを使用すると、ローダーが提供する証拠がアセンブリに読み込まれます。

• Load パラメーターで Evidence メソッドを使用すると、証拠の一部がマージされます。 Loadメソッドの引数として提供される証拠の一部は、ローダーによって提供される証拠の一部よりも優先されます。

• 共通オブジェクト ファイル形式 (COFF) イメージを読み込むには、Load パラメーターでByte[] メソッドのオーバーロードを使用すると、呼び出し元のアセンブリから証拠が継承されます。

• Load パラメーターとByte[]を指定して Evidence メソッドを使用して COFF イメージを読み込む場合、指定された証拠のみが使用されます。 呼び出し元アセンブリの証拠と COFF イメージの証拠は無視されます。

同じアセンブリでこのメソッドを複数回呼び出したが、異なる証拠が指定されている場合、共通言語ランタイムは、異なる証拠仕様の等価性と整合性を判断できないため、 FileLoadException をスローしません。 最初に成功する証拠は、使用される証拠です。

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

こちらもご覧ください

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

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef, System::Security::Policy::Evidence ^ assemblySecurity);

public static System.Reflection.Assembly Load(System.Reflection.AssemblyName assemblyRef, System.Security.Policy.Evidence assemblySecurity);

[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load(System.Reflection.AssemblyName assemblyRef, System.Security.Policy.Evidence assemblySecurity);

static member Load : System.Reflection.AssemblyName * System.Security.Policy.Evidence -> System.Reflection.Assembly

[<System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member Load : System.Reflection.AssemblyName * System.Security.Policy.Evidence -> System.Reflection.Assembly

Public Shared Function Load (assemblyRef As AssemblyName, assemblySecurity As Evidence) As Assembly

パラメーター

返品

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

属性

ObsoleteAttribute

例外

注釈

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

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

アセンブリに対して特定の権限が付与されているかどうかは、証拠に基づいています。 アセンブリとセキュリティ証拠のマージの規則は次のとおりです。

• Load パラメーターを指定しないEvidence メソッドを使用すると、ローダーが提供する証拠がアセンブリに読み込まれます。

• Load パラメーターで Evidence メソッドを使用すると、証拠の一部がマージされます。 Loadメソッドの引数として提供される証拠の一部は、ローダーによって提供される証拠の一部よりも優先されます。

• 共通オブジェクト ファイル形式 (COFF) イメージを読み込むには、Load パラメーターでByte[] メソッドのオーバーロードを使用すると、呼び出し元のアセンブリから証拠が継承されます。

• Load パラメーターとByte[]を指定して Evidence メソッドを使用して COFF イメージを読み込む場合、指定された証拠のみが使用されます。 呼び出し元アセンブリの証拠と COFF イメージの証拠は無視されます。

同じアセンブリで Load メソッドを複数回呼び出したが、異なる証拠が指定されている場合、共通言語ランタイムは、異なる証拠仕様の等価性と整合性を判断できないため、 FileLoadException をスローしません。 最初に成功する証拠は、使用される証拠です。

こちらもご覧ください

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

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

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

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

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

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

パラメーター

返品

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

属性

RequiresUnreferencedCodeAttribute

例外

注釈

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

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

ソース:

Assembly.CoreCLR.cs

ソース:

Assembly.CoreCLR.cs

ソース:

Assembly.CoreCLR.cs

ソース:

Assembly.CoreCLR.cs

ソース:

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

パラメーター

返品

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

例外

例

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

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)
• ランタイムがアセンブリを検索する方法

ソース:

Assembly.CoreCLR.cs

ソース:

Assembly.CoreCLR.cs

ソース:

Assembly.CoreCLR.cs

ソース:

Assembly.CoreCLR.cs

ソース:

Assembly.CoreCLR.cs

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

パラメーター

返品

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

例外

例

次の例では、 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 コンテキストに読み込まれます。 アセンブリの読み込みの詳細については、「 マネージド アセンブリ読み込みアルゴリズム」を参照してください。

こちらもご覧ください

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

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

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

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

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

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

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

パラメーター

返品

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

属性

RequiresUnreferencedCodeAttribute

例外

注釈

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

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

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