NativeLibrary.Load Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Przeciążenia

Load(String)	Udostępnia prosty interfejs API do ładowania biblioteki natywnej, która opakowuje moduł ładujący systemu operacyjnego i używa flag domyślnych.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Udostępnia interfejs API wysokiego poziomu do ładowania biblioteki natywnej.

Load(String)

Źródło:

NativeLibrary.cs

Udostępnia prosty interfejs API do ładowania biblioteki natywnej, która opakowuje moduł ładujący systemu operacyjnego i używa flag domyślnych.

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

Parametry

libraryPath

String

Nazwa biblioteki natywnej do załadowania.

Zwraca

IntPtr

nativeint

Uchwyt systemu operacyjnego dla załadowanego biblioteki natywnej.

Wyjątki

ArgumentNullException

libraryPath to null.

DllNotFoundException

Nie można odnaleźć biblioteki.

BadImageFormatException

Biblioteka jest nieprawidłowa.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Źródło:

NativeLibrary.cs

Udostępnia interfejs API wysokiego poziomu do ładowania biblioteki natywnej.

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

Parametry

libraryName

String

Nazwa biblioteki natywnej do załadowania.

assembly

Assembly

Zestaw ładuje bibliotekę natywną.

searchPath

Nullable<DllImportSearchPath>

Ścieżka wyszukiwania.

Zwraca

IntPtr

nativeint

Uchwyt systemu operacyjnego dla załadowanego biblioteki.

Wyjątki

ArgumentNullException

libraryName lub assembly to null.

ArgumentException

assembly nie jest elementem RuntimeAssembly.

DllNotFoundException

Nie można odnaleźć biblioteki.

BadImageFormatException

Biblioteka jest nieprawidłowa.

Uwagi

Biorąc pod uwagę nazwę biblioteki, ta metoda wyszukuje określone ścieżki na podstawie konfiguracji środowiska uruchomieniowego, parametrów wejściowych i atrybutów zestawu wywołującego. searchPath Jeśli parametr jest inny niż null, używane są flagi w tym wyliczenie. W przeciwnym razie są używane flagi określone przez DefaultDllImportSearchPathsAttribute zestaw wywołujący, jeśli istnieją. Ta metoda nie wywołuje zarejestrowanego narzędzia rozpoznawania przy użyciu SetDllImportResolver(Assembly, DllImportResolver) metody . Począwszy od platformy .NET 5, ta metoda wywołuje metodę AssemblyLoadContext.LoadUnmanagedDll i AssemblyLoadContext.ResolvingUnmanagedDll zdarzenie.