NativeLibrary.Load Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Surcharges

Load(String)	Fournit une API simple pour le chargement d’une bibliothèque native qui encapsule le chargeur du système d’exploitation et utilise des indicateurs par défaut.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Fournit une API de haut niveau pour le chargement d’une bibliothèque native.

Load(String)

Source:

NativeLibrary.cs

Fournit une API simple pour le chargement d’une bibliothèque native qui encapsule le chargeur du système d’exploitation et utilise des indicateurs par défaut.

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

Paramètres

libraryPath

String

Nom de la bibliothèque native à charger.

Retours

IntPtr

nativeint

Descripteur de système d’exploitation de la bibliothèque native chargée.

Exceptions

ArgumentNullException

libraryPath a la valeur null.

DllNotFoundException

La bibliothèque est introuvable.

BadImageFormatException

La bibliothèque n’est pas valide.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Source:

NativeLibrary.cs

Fournit une API de haut niveau pour le chargement d’une bibliothèque native.

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

Paramètres

libraryName

String

Nom de la bibliothèque native à charger.

assembly

Assembly

Assembly chargeant la bibliothèque native.

searchPath

Nullable<DllImportSearchPath>

Chemin de recherche.

Retours

IntPtr

nativeint

Descripteur de système d’exploitation de la bibliothèque chargée.

Exceptions

ArgumentNullException

libraryName ou assembly est null.

ArgumentException

assembly n’est pas un RuntimeAssembly.

DllNotFoundException

La bibliothèque est introuvable.

BadImageFormatException

La bibliothèque n’est pas valide.

Remarques

Avec un nom de bibliothèque, cette méthode recherche des chemins d’accès spécifiques en fonction de la configuration du runtime, des paramètres d’entrée et des attributs de l’assembly appelant. Si le searchPath paramètre n’est pas null, les indicateurs de cette énumération sont utilisés. Sinon, les indicateurs spécifiés par sur l’assembly DefaultDllImportSearchPathsAttribute appelant, le cas échéant, sont utilisés. Cette méthode n’appelle pas le programme de résolution inscrit à l’aide de SetDllImportResolver(Assembly, DllImportResolver) la méthode . À compter de .NET 5, cette méthode appelle la AssemblyLoadContext.LoadUnmanagedDll méthode et l’événement AssemblyLoadContext.ResolvingUnmanagedDll .