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

Dojście 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 ładujący 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 ma wartość inną niż null, używane są flagi w tym wyliczenie. W przeciwnym razie używane są flagi określone przez DefaultDllImportSearchPathsAttribute element w zestawie wywołującym, jeśli istnieją. Ta metoda nie wywołuje programu rozpoznawania nazw zarejestrowanych przy użyciu SetDllImportResolver(Assembly, DllImportResolver) metody . Począwszy od platformy .NET 5, ta metoda wywołuje metodę AssemblyLoadContext.LoadUnmanagedDll i AssemblyLoadContext.ResolvingUnmanagedDll zdarzenie.