NativeLibrary.Load 方法

定义

命名空间:

System.Runtime.InteropServices

程序集:

System.Runtime.InteropServices.dll

重载

Load(String)	提供一个简单 API，用于加载包装 OS 加载程序并使用模式标志的本机库。
Load(String, Assembly, Nullable<DllImportSearchPath>)	提供用于加载本机库的高级 API。

Load(String)

Source:

NativeLibrary.cs

提供一个简单 API，用于加载包装 OS 加载程序并使用模式标志的本机库。

public:
 static IntPtr Load(System::String ^ libraryPath);

public static IntPtr Load (string libraryPath);

static member Load : string -> nativeint

Public Shared Function Load (libraryPath As String) As IntPtr

参数

libraryPath

String

要加载的本机库的名称。

返回

IntPtr

nativeint

已加载的本机库的 OS 句柄。

例外

ArgumentNullException

libraryPath 为 null。

DllNotFoundException

找不到库。

BadImageFormatException

库无效。

Load(String, Assembly, Nullable<DllImportSearchPath>)

Source:

NativeLibrary.cs

提供用于加载本机库的高级 API。

public:
 static IntPtr Load(System::String ^ libraryName, System::Reflection::Assembly ^ assembly, Nullable<System::Runtime::InteropServices::DllImportSearchPath> searchPath);

public static IntPtr Load (string libraryName, System.Reflection.Assembly assembly, System.Runtime.InteropServices.DllImportSearchPath? searchPath);

static member Load : string * System.Reflection.Assembly * Nullable<System.Runtime.InteropServices.DllImportSearchPath> -> nativeint

Public Shared Function Load (libraryName As String, assembly As Assembly, searchPath As Nullable(Of DllImportSearchPath)) As IntPtr

参数

libraryName

String

要加载的本机库的名称。

assembly

Assembly

用于加载本机库的程序集。

searchPath

Nullable<DllImportSearchPath>

搜索路径。

返回

IntPtr

nativeint

已加载的库的 OS 句柄。

例外

ArgumentNullException

libraryName 或 assembly 为 null。

ArgumentException

assembly 不是 RuntimeAssembly。

DllNotFoundException

找不到库。

BadImageFormatException

库无效。

注解

给定库名称后，此方法根据运行时配置、输入参数和调用程序集的属性搜索特定路径。 searchPath如果 参数为非 null，则使用此枚举中的标志。 否则，将使用由调用程序集上的 指定的 DefaultDllImportSearchPathsAttribute 标志（如果有）。 此方法不调用使用 SetDllImportResolver(Assembly, DllImportResolver) 方法注册的解析程序。 从 .NET 5 开始，此方法会调用 AssemblyLoadContext.LoadUnmanagedDll 方法和 AssemblyLoadContext.ResolvingUnmanagedDll 事件。