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

Предоставляет простой интерфейс 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

Предоставляет высокоуровневый интерфейс 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 событие .

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