NativeLibrary.Load Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Überlädt

Load(String)	Bietet eine einfache API zum Laden einer nativen Bibliothek, die das Betriebssystem-Ladeprogramm umschließt und Standardflags verwendet.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Bietet eine API auf höchster Stufe zum Laden einer nativen Bibliothek.

Load(String)

Quelle:

NativeLibrary.cs

Bietet eine einfache API zum Laden einer nativen Bibliothek, die das Betriebssystem-Ladeprogramm umschließt und Standardflags verwendet.

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

Parameter

libraryPath

String

Der Name der zu ladenden nativen Bibliothek.

Gibt zurück

IntPtr

nativeint

Das Betriebssystemhandle für die geladene native Bibliothek.

Ausnahmen

ArgumentNullException

libraryPath ist null.

DllNotFoundException

Die Bibliothek wurde nicht gefunden.

BadImageFormatException

Die Bibliothek ist nicht gültig.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Quelle:

NativeLibrary.cs

Bietet eine API auf höchster Stufe zum Laden einer nativen Bibliothek.

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

Parameter

libraryName

String

Der Name der zu ladenden nativen Bibliothek.

assembly

Assembly

Die Assembly, die die native Bibliothek lädt.

searchPath

Nullable<DllImportSearchPath>

Der Suchpfad.

Gibt zurück

IntPtr

nativeint

Das Betriebssystemhandle für die geladene Bibliothek.

Ausnahmen

ArgumentNullException

libraryName oder assembly ist null.

ArgumentException

assembly ist keine RuntimeAssembly.

DllNotFoundException

Die Bibliothek wurde nicht gefunden.

BadImageFormatException

Die Bibliothek ist nicht gültig.

Hinweise

Bei Einem Bibliotheksnamen durchsucht diese Methode bestimmte Pfade basierend auf der Laufzeitkonfiguration, den Eingabeparametern und den Attributen der aufrufenden Assembly. Wenn der searchPath Parameter ungleich NULL ist, werden die Flags in dieser Enumeration verwendet. Andernfalls werden die flags verwendet, die von für DefaultDllImportSearchPathsAttribute die aufrufende Assembly angegeben sind, sofern vorhanden. Diese Methode ruft den mit der - SetDllImportResolver(Assembly, DllImportResolver) Methode registrierten Resolver nicht auf. Ab .NET 5 ruft diese Methode die AssemblyLoadContext.LoadUnmanagedDll -Methode und das AssemblyLoadContext.ResolvingUnmanagedDll -Ereignis auf.