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 元件) 的 「系統」，以及其版本、文化特性、公鑰令牌，以及選擇性的處理器架構。 它會對應至元件的 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

無法載入找到的檔案。

-或-

僅限 .NET Framework： 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： 請參閱 <loadFromRemoteSources> 以從遠端位置載入元件。

注意

僅限 .NET Framework：請勿只CodeBase搭配屬性集使用 AssemblyName 。 CodeBase屬性不會提供元件識別的任何元素 (，例如名稱或版本) ，因此載入不會根據依身分識別規則載入，如同您預期從 Load 方法一樣。 相反地，元件會使用載入自規則來載入。 如需使用從載入內容之缺點的資訊，請參閱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);

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