NativeLibrary.Load Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Перегрузки

Load(String)	Предоставляет простой интерфейс API для загрузки собственной библиотеки, который инкапсулирует загрузчик ОС и использует флаги по умолчанию.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Предоставляет высокоуровневый интерфейс API для загрузки собственной библиотеки.

Load(String)

Исходный код:

NativeLibrary.cs

Предоставляет простой интерфейс API для загрузки собственной библиотеки, который инкапсулирует загрузчик ОС и использует флаги по умолчанию.

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

Дескриптор ОС для загруженной собственной библиотеки.

Исключения

ArgumentNullException

libraryPath имеет значение null.

DllNotFoundException

Не удается найти библиотеку.

BadImageFormatException

Библиотека недопустима.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Исходный код:

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

Дескриптор ОС для загруженной библиотеки.

Исключения

ArgumentNullException

Параметр libraryName или assembly имеет значение null.

ArgumentException

assembly не является объектом типа RuntimeAssembly.

DllNotFoundException

Не удается найти библиотеку.

BadImageFormatException

Библиотека недопустима.

Комментарии

Учитывая имя библиотеки, этот метод выполняет поиск по определенным путям на основе конфигурации среды выполнения, входных параметров и атрибутов вызывающей сборки. searchPath Если параметр не равен NULL, используются флаги в этом перечислении. В противном случае используются флаги, указанные DefaultDllImportSearchPathsAttribute в вызывающей сборке, если таковые имеются. Этот метод не вызывает сопоставитель, зарегистрированный с помощью SetDllImportResolver(Assembly, DllImportResolver) метода . Начиная с .NET 5 этот метод вызывает AssemblyLoadContext.LoadUnmanagedDll метод и AssemblyLoadContext.ResolvingUnmanagedDll событие .