Assembly.LoadFrom 方法

定义

命名空间:

System.Reflection

程序集:

System.Runtime.dll

加载程序集。

重载

LoadFrom(String, Byte[], AssemblyHashAlgorithm)	通过给定程序集文件名或路径、哈希值及哈希算法来加载程序集。
LoadFrom(String)	已知程序集的文件名或路径，加载程序集。

注解

从 .NET Framework 4 开始，默认情况下禁用从远程位置加载的程序集中执行代码的功能，并且对 LoadFrom 方法的调用将FileLoadException引发 。 若要加载程序集并执行其代码，你必须：

• 显式为程序集创建沙盒。 (请参阅 如何：在 Sandbox 中运行部分受信任的代码。)

• 通过将配置元素的 属性<loadFromRemoteSources>设置为 trueenabled ，以完全信任方式运行程序集的代码。 有关详细信息，请参阅配置元素一<loadFromRemoteSources>文。

LoadFrom(String, Byte[], AssemblyHashAlgorithm)

Source:

Assembly.cs

通过给定程序集文件名或路径、哈希值及哈希算法来加载程序集。

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);

public static System.Reflection.Assembly LoadFrom (string assemblyFile, byte[]? hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

static member LoadFrom : string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As Assembly

参数

assemblyFile

String

包含程序集清单的文件的名称或路径。

hashValue

Byte[]

计算所得的哈希代码的值。

hashAlgorithm

AssemblyHashAlgorithm

用于对文件进行哈希处理并生成强名称的哈希算法。

返回

Assembly

加载的程序集。

例外

ArgumentNullException

assemblyFile 为 null。

FileNotFoundException

未找到 assemblyFile，或者你正在试图加载的模块未指定文件扩展名。

FileLoadException

无法加载已找到的文件。

- 或 -

在远程程序集中执行代码的功能已禁用。 请参阅 <loadFromRemoteSources>。

BadImageFormatException

assemblyFile 不是当前加载的运行时的有效程序集;例如，64 位进程中的 32 位程序集。

SecurityException

指定了不以“file://”开头的基本代码，且没有所需的 WebPermission。

ArgumentException

assemblyFile 参数为空字符串 ("")。

PathTooLongException

程序集名称超过系统定义的最大长度。

注解

参数 assemblyFile 必须引用不带转义字符的 URI。 此方法为 URI 中的所有无效字符提供转义字符。

注意

不支持文件传输协议 (FTP) 。 如果提供的 assemblyFile URI 是 FTP 地址，则不会加载程序集。 不会引发异常。

assemblyFile 可以是绝对目录，也可以相对于当前目录。

程序集可以加载到三个上下文之一，也可以在没有上下文的情况下加载：

• 加载上下文包含通过探测找到的程序集：在全局程序集缓存中、在主机程序集存储（如果托管运行时）中，或在应用程序域的 和 PrivateBinPath 中ApplicationBase。 Load 方法的大多数重载都将程序集加载到此上下文中。

• 从加载上下文包含用户提供了未包含在探测中的路径的程序集。 LoadFrom、CreateInstanceFrom 和 ExecuteAssembly 都是通过路径加载的方法的示例。

  从 .NET Framework 4 开始，如果 的 assemblyFile URI 指定远程位置，则默认情况下禁用程序集加载，并且 LoadFrom 方法将FileLoadException引发 。 若要启用从远程位置加载的代码的执行，可以使用 <loadFromRemoteSources> 配置元素。

• 仅反射上下文包含使用 ReflectionOnlyLoad 和 ReflectionOnlyLoadFrom 方法加载的程序集;无法执行这些上下文中的代码。

• 如果用户生成或找到了程序集，则它不在任何上下文中。 这适用于使用指定包含程序集的字节数组的方法重 Load 载加载的程序集，以及使用反射发出且未保存到磁盘的暂时性动态程序集。

从加载上下文允许从未包含在探测中的路径加载程序集，但允许查找和加载该路径的依赖项，因为路径信息由上下文维护。

方法 LoadFrom 具有以下缺点。 请考虑改用 Load。

• 如果已加载一个具有相同标识的程序集，则即使指定了不同的路径，LoadFrom 仍返回已加载的程序集。

• 如果使用 加载程序集 LoadFrom，然后加载上下文中的程序集尝试按显示名称加载同一程序集，则加载尝试将失败。 对程序集进行反序列化时，可能发生这种情况。

• 如果使用 加载 LoadFrom程序集，并且探测路径包含具有相同标识但位置不同的程序集， InvalidCastException则会发生 、 MissingMethodException或其他意外行为。

• LoadFrom 需要对指定路径的 FileIOPermissionAccess.Read 和 FileIOPermissionAccess.PathDiscovery 或 WebPermission。

• 如果 存在 的 assemblyFile本机映像，则不使用该映像。 程序集不能以非特定于域的方式加载。

程序集加载有加载程序提供的证据。

LoadFrom(String)

Source:

Assembly.cs

已知程序集的文件名或路径，加载程序集。

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile);

public static System.Reflection.Assembly LoadFrom (string assemblyFile);

static member LoadFrom : string -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String) As Assembly

参数

assemblyFile

String

包含程序集清单的文件的名称或路径。

返回

Assembly

加载的程序集。

例外

ArgumentNullException

assemblyFile 为 null。

FileNotFoundException

未找到 assemblyFile，或者你正在试图加载的模块未指定文件名扩展。

FileLoadException

无法加载已找到的文件。

- 或 -

在远程程序集中执行代码的功能已禁用。 请参阅 <loadFromRemoteSources>。

BadImageFormatException

assemblyFile 不是当前加载的运行时的有效程序集;例如，64 位进程中的 32 位程序集。

SecurityException

指定了不以“file://”开头的基本代码，且没有所需的 WebPermission。

ArgumentException

assemblyFile 参数为空字符串 ("")。

PathTooLongException

程序集名称超过系统定义的最大长度。

示例

以下示例根据程序集的文件名或路径加载程序集。

Assembly^ SampleAssembly;
SampleAssembly = Assembly::LoadFrom( "c:\\Sample.Assembly.dll" );
// Obtain a reference to a method known to exist in assembly.
MethodInfo^ Method = SampleAssembly->GetTypes()[ 0 ]->GetMethod( "Method1" );
// Obtain a reference to the parameters collection of the MethodInfo instance.
array<ParameterInfo^>^ Params = Method->GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System::String
//   Position = 0
//   Optional=False
for each ( ParameterInfo^ Param in Params )
{
   Console::WriteLine( "Param= {0}", Param->Name );
   Console::WriteLine( "  Type= {0}", Param->ParameterType );
   Console::WriteLine( "  Position= {0}", Param->Position );
   Console::WriteLine( "  Optional= {0}", Param->IsOptional );
}

Assembly SampleAssembly;
SampleAssembly = Assembly.LoadFrom("c:\\Sample.Assembly.dll");
// Obtain a reference to a method known to exist in assembly.
MethodInfo Method = SampleAssembly.GetTypes()[0].GetMethod("Method1");
// Obtain a reference to the parameters collection of the MethodInfo instance.
ParameterInfo[] Params = Method.GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System.String
//   Position = 0
//   Optional=False
foreach (ParameterInfo Param in Params)
{
    Console.WriteLine("Param=" + Param.Name.ToString());
    Console.WriteLine("  Type=" + Param.ParameterType.ToString());
    Console.WriteLine("  Position=" + Param.Position.ToString());
    Console.WriteLine("  Optional=" + Param.IsOptional.ToString());
}

Dim SampleAssembly As [Assembly]
SampleAssembly = [Assembly].LoadFrom("c:\Sample.Assembly.dll")
' Obtain a reference to a method known to exist in assembly.
Dim Method As MethodInfo = SampleAssembly.GetTypes()(0).GetMethod("Method1")
' Obtain a reference to the parameters collection of the MethodInfo instance.
Dim Params As ParameterInfo() = Method.GetParameters()
' Display information about method parameters.
' Param = sParam1
'   Type = System.String
'   Position = 0
'   Optional=False
For Each Param As ParameterInfo In Params
    Console.WriteLine(("Param=" + Param.Name.ToString()))
    Console.WriteLine(("  Type=" + Param.ParameterType.ToString()))
    Console.WriteLine(("  Position=" + Param.Position.ToString()))
    Console.WriteLine(("  Optional=" + Param.IsOptional.ToString()))
Next

注解

参数 assemblyFile 必须引用不带转义字符的 URI。 此方法为 URI 中的所有无效字符提供转义字符。

注意

不支持文件传输协议 (FTP) 。 如果提供的 assemblyFile URI 是 FTP 地址，则不会加载程序集。 不会引发异常。

assemblyFile 可以是绝对的，也可以是相对于当前目录的。

程序集可以加载到三个上下文之一，也可以在没有上下文的情况下加载：

• 加载上下文包含通过探测找到的程序集：在 GAC 中、托管运行时时位于主机程序集存储区中，或在应用程序域的 和 PrivateBinPath 中ApplicationBase。 Load 方法的大多数重载都将程序集加载到此上下文中。

• 从加载上下文包含用户提供的路径未包含在探测搜索的目录中的程序集。 LoadFrom、CreateInstanceFrom 和 ExecuteAssembly 都是通过路径加载的方法的示例。

  从 .NET Framework 4 开始，如果 的 assemblyFile URI 指定远程位置，则默认情况下禁用程序集加载，并且 LoadFrom 方法将FileLoadException引发 。 若要启用从远程位置加载的代码的执行，可以使用 <loadFromRemoteSources> 配置元素。

• 仅反射上下文包含使用 ReflectionOnlyLoad 和 ReflectionOnlyLoadFrom 方法加载的程序集;无法执行这些上下文中的代码。

• 如果用户生成或找到了程序集，则它不在任何上下文中。 这适用于使用指定包含程序集的字节数组的方法重 Load 载加载的程序集，以及使用反射发出且未保存到磁盘的暂时性动态程序集。

从加载上下文允许从未包含在探测中的路径加载程序集，但允许查找和加载该路径上的依赖项，因为路径信息由上下文维护。

方法 LoadFrom 具有以下缺点。 请考虑改用 Load。

• 如果具有相同标识的程序集已加载到加载源上下文中，则即使指定了不同的路径，LoadFrom 也仍会返回已加载的程序集。

• 即使加载上下文中存在具有相同标识的程序集，也可以从加载上下文中加载程序集。 两个程序集之间的互操作性不起作用，从而导致错误（如 InvalidCastException、 MissingMethodException或其他意外行为）。

• 使用探测路径中的位置调用 LoadFrom 将在加载上下文中加载程序集，而不是加载自加载上下文中。

• 如果将标识由绑定重定向策略保护的程序集文件传递给 LoadFrom，则将应用该策略，并且将从加载上下文中的探测路径加载程序集。

• 如果在 load-from 上下文中加载程序集，并且稍后加载上下文中的程序集尝试按显示名称加载同一程序集，则加载尝试将失败。 对程序集进行反序列化时，可能发生这种情况。

• LoadFrom 需要对指定路径的 FileIOPermissionAccess.Read 和 FileIOPermissionAccess.PathDiscovery 或 WebPermission。

• 如果 存在 的 assemblyFile本机映像，则不使用该映像。 程序集不能作为非特定域加载。