NativeLibrary.Load Метод

Определение

Пространство имен:
System.Runtime.InteropServices
Сборка:
System.Runtime.InteropServices.dll

Перегрузки

Имя Описание
Load(String)

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

Предоставляет высокоуровневый API для загрузки собственной библиотеки.

Load(String)

Исходный код:
NativeLibrary.cs
Исходный код:
NativeLibrary.cs
Исходный код:
NativeLibrary.cs
Исходный код:
NativeLibrary.cs
Исходный код:
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
Исходный код:
NativeLibrary.cs
Исходный код:
NativeLibrary.cs
Исходный код:
NativeLibrary.cs
Исходный код:
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.

Применяется к