Assembly.Load 方法

定義

命名空間:

System.Reflection

組件:

netstandard.dll, System.Runtime.dll

裝載一個組件。

多載

名稱	Description
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 是一條零長度的字串。

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 assembly：

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

找到的檔案無法載入。

-或-

僅限 .NET Framework 使用：assemblyRef根據 loadFromRemoteSources> 指定一個被停用<的位置。

注意：在 .NET for Windows Store 應用程式 或 Portable 類別函式庫中，請擷取基底類別例外， 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集來使用 aAssemblyName。 該 CodeBase 屬性不提供組裝身分的任何元素（如名稱或版本），因此載入並非依照身份載入規則進行，這與該方法所預期 Load 的關係不同。 組裝則是依照載入規則（load-from）來載入。 關於使用 load-from（載入點）上下文的缺點，請參閱 Assembly.LoadFrom 方法過載或組裝 裝載最佳實務。

備註

僅限 .NET Framework：如果屬性與屬性都AssemblyName.NameAssemblyName.CodeBase被設定，第一次載入組合語言時會使用顯示名稱（包括屬性回傳Assembly.FullName的版本、文化等）。 若找不到該檔案， CodeBase 則用於搜尋該組合。 若該組件以 CodeBase找到，則顯示名稱與組件相匹配。 若配對失敗，則擲出 a 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)