NativeLibrary.Load Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Przeciążenia

Nazwa	Opis
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

Dojście systemu operacyjnego dla załadowanego biblioteki natywnej.

Wyjątki

ArgumentNullException

Parametr libraryPath ma wartość 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

Dojście systemu operacyjnego dla załadowanego biblioteki.

Wyjątki

ArgumentNullException

libraryName lub assembly ma wartość null.

ArgumentException

assemblynie jest .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 programu resolver zarejestrowanego przy użyciu SetDllImportResolver(Assembly, DllImportResolver) metody . Począwszy od .NET 5, ta metoda wywołuje metodę AssemblyLoadContext.LoadUnmanagedDll i zdarzenie AssemblyLoadContext.ResolvingUnmanagedDll.