NativeLibrary.Load Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Overload

Load(String)	Offre una semplice API per il caricamento di una libreria nativa che esegue il wrapping del caricatore del sistema operativo e usa i flag predefiniti.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Offre un'API avanzata per il caricamento di una libreria nativa.

Load(String)

Origine:

NativeLibrary.cs

Offre una semplice API per il caricamento di una libreria nativa che esegue il wrapping del caricatore del sistema operativo e usa i flag predefiniti.

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

Parametri

libraryPath

String

Nome della libreria nativa da caricare.

Restituisce

IntPtr

nativeint

Handle del sistema operativo per la libreria nativa caricata.

Eccezioni

ArgumentNullException

libraryPath è null.

DllNotFoundException

La libreria non è stata trovata.

BadImageFormatException

La libreria non è valida.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Origine:

NativeLibrary.cs

Offre un'API avanzata per il caricamento di una libreria nativa.

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

Parametri

libraryName

String

Nome della libreria nativa da caricare.

assembly

Assembly

Assembly che carica la libreria nativa.

searchPath

Nullable<DllImportSearchPath>

Percorso di ricerca.

Restituisce

IntPtr

nativeint

Handle del sistema operativo per la libreria caricata.

Eccezioni

ArgumentNullException

libraryName o assembly è null.

ArgumentException

assembly non è un oggetto RuntimeAssembly.

DllNotFoundException

La libreria non è stata trovata.

BadImageFormatException

La libreria non è valida.

Commenti

Dato un nome di libreria, questo metodo cerca percorsi specifici in base alla configurazione di runtime, ai parametri di input e agli attributi dell'assembly chiamante. Se il searchPath parametro è diverso da Null, vengono usati i flag in questa enumerazione. In caso contrario, vengono utilizzati i flag specificati da DefaultDllImportSearchPathsAttribute nell'assembly chiamante, se presenti. Questo metodo non richiama il sistema di risoluzione registrato utilizzando il SetDllImportResolver(Assembly, DllImportResolver) metodo . A partire da .NET 5, questo metodo richiama il AssemblyLoadContext.LoadUnmanagedDll metodo e l'evento AssemblyLoadContext.ResolvingUnmanagedDll .