Assembly.Load 方法

定義

命名空間:

System.Reflection

組件:

System.Runtime.dll

載入組件。

多載

Load(Byte[])	載入具有通用物件檔案格式 (Common Object File Format，COFF) 之映像的組件 (包含發出的組件)。
Load(String)	載入具有指定名稱的組件。
Load(AssemblyName)	載入組件，指定其 AssemblyName。
Load(Byte[], Byte[])	使用通用物件檔案格式 (COFF) 映像載入組件，其中包含已發出的組件，並可選擇性地包含組件的符號。

Load(Byte[])

來源:

Assembly.cs

載入具有通用物件檔案格式 (Common Object File Format，COFF) 之映像的組件 (包含發出的組件)。

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)

來源:

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 是零長度字串

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 版中，處理器架構會新增至元件識別，並可指定為元件名稱字串的一部分。 例如，“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

無法載入找到的檔案。

-或-

assemblyRef 指定遠端組件，但已停用在遠端組件中執行程式碼的能力。 請參閱 <loadFromRemoteSources>。

注意：在 適用於 Windows 市集應用程式的 .NET 或 可攜式類別庫中，改為攔截基類例外狀況 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 開始，因為預設會停用遠端元件中的程式代碼執行，如果assemblyRef指定遠端元件，FileLoadException也會擲回 。 若要啟用從遠端位置載入的程式代碼執行，您可以使用 <loadFromRemoteSources> 組態專案。

注意

請勿只CodeBase搭配屬性集使用 AssemblyName 。 屬性 CodeBase 不會提供元件身分識別的任何元素 (，例如名稱或版本) ，因此載入不會根據依身分識別規則進行，因為您預期來自 Load 方法。 相反地，元件會使用來自規則的載入來載入。 如需使用從內容載入之缺點的資訊，請參閱 Assembly.LoadFrom 元件載入的方法多載或 最佳做法。

注意

如果同時 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);

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) 方法多載。