NativeLibrary.Load Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Přetížení

Load(String)	Poskytuje jednoduché rozhraní API pro načtení nativní knihovny, která zabalí zavaděč operačního systému a používá výchozí příznaky.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Poskytuje rozhraní API vysoké úrovně pro načtení nativní knihovny.

Load(String)

Zdroj:

NativeLibrary.cs

Poskytuje jednoduché rozhraní API pro načtení nativní knihovny, která zabalí zavaděč operačního systému a používá výchozí příznaky.

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

Název nativní knihovny, která se má načíst.

Návraty

IntPtr

nativeint

Popisovač operačního systému pro načtenou nativní knihovnu.

Výjimky

ArgumentNullException

libraryPath je null.

DllNotFoundException

Knihovnu nelze najít.

BadImageFormatException

Knihovna není platná.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Zdroj:

NativeLibrary.cs

Poskytuje rozhraní API vysoké úrovně pro načtení nativní knihovny.

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

Název nativní knihovny, která se má načíst.

assembly

Assembly

Sestavení načítá nativní knihovnu.

searchPath

Nullable<DllImportSearchPath>

Cesta hledání.

Návraty

IntPtr

nativeint

Popisovač operačního systému pro načtenou knihovnu.

Výjimky

ArgumentNullException

libraryName nebo assembly je null.

ArgumentException

assemblynení .RuntimeAssembly

DllNotFoundException

Knihovnu nelze najít.

BadImageFormatException

Knihovna není platná.

Poznámky

Vzhledem k názvu knihovny tato metoda prohledává konkrétní cesty na základě konfigurace modulu runtime, vstupních parametrů a atributů volajícího sestavení. searchPath Pokud parametr není null, použijí se příznaky v tomto výčtu. V opačném případě se použijí příznaky určené DefaultDllImportSearchPathsAttribute na volajícím sestavení, pokud jsou k dispozici. Tato metoda nevyvolá překladač zaregistrovaný pomocí SetDllImportResolver(Assembly, DllImportResolver) metody. Počínaje .NET 5 tato metoda vyvolá metodu AssemblyLoadContext.LoadUnmanagedDll a AssemblyLoadContext.ResolvingUnmanagedDll událost.