Assembly.Load 方法

定义

命名空间:

System.Reflection

程序集:

System.Runtime.dll

加载程序集。

重载

Load(Byte[])	加载带有基于通用对象文件格式 (COFF) 的映像的程序集，该映像包含已发出的程序集。
Load(String)	用指定的名称加载程序集。
Load(AssemblyName)	在给定程序集的 AssemblyName 的情况下，加载程序集。
Load(Byte[], Byte[])	加载带有基于通用对象文件格式 (COFF) 的映像的程序集，此映像包含一个已发出的程序集，并且还可以选择包括程序集的符号。

Load(Byte[])

Source:

Assembly.cs

加载带有基于通用对象文件格式 (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)

Source:

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)

Source:

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 的那样。 相反，程序集是使用 load-from 规则加载的。 有关使用从上下文加载的缺点的信息，请参阅 Assembly.LoadFrom 方法重载或 程序集加载的最佳做法。

注意

仅限 .NET Framework： 如果同时 AssemblyName.Name 设置了 属性和 AssemblyName.CodeBase 属性，则首次尝试加载程序集将使用显示名称 (包括版本、区域性等，属性) 返回 Assembly.FullName 。 如果未找到该文件， CodeBase 则用于搜索程序集。 如果使用 找到 CodeBase程序集，则显示名称与程序集匹配。 如果匹配失败， FileLoadException 则会引发 。

另请参阅

• AssemblyName
• 运行时如何定位程序集

Load(Byte[], Byte[])

Source:

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) 方法重载。