NativeLibrary.Load Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Sobrecargas

Load(String)	Fornece uma API de exemplo para carregar uma biblioteca nativa que encapsula o carregador do sistema operacional e usa sinalizadores padrão.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Fornece uma API de alto nível para carregar uma biblioteca nativa.

Load(String)

Origem:

NativeLibrary.cs

Fornece uma API de exemplo para carregar uma biblioteca nativa que encapsula o carregador do sistema operacional e usa sinalizadores padrão.

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

Parâmetros

libraryPath

String

O nome da biblioteca nativa a ser carregada.

Retornos

IntPtr

nativeint

O identificador de SO da biblioteca nativa carregada.

Exceções

ArgumentNullException

libraryPath é null.

DllNotFoundException

A biblioteca não pode ser encontrada.

BadImageFormatException

A biblioteca não é válida.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Origem:

NativeLibrary.cs

Fornece uma API de alto nível para carregar uma biblioteca 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

Parâmetros

libraryName

String

O nome da biblioteca nativa a ser carregada.

assembly

Assembly

O assembly que está carregando a biblioteca nativa.

searchPath

Nullable<DllImportSearchPath>

O caminho de pesquisa.

Retornos

IntPtr

nativeint

O identificador de SO da biblioteca carregada.

Exceções

ArgumentNullException

libraryName ou assembly é null.

ArgumentException

assembly não é um RuntimeAssembly.

DllNotFoundException

A biblioteca não pode ser encontrada.

BadImageFormatException

A biblioteca não é válida.

Comentários

Dado um nome de biblioteca, esse método pesquisa caminhos específicos com base na configuração de runtime, parâmetros de entrada e atributos do assembly de chamada. Se o searchPath parâmetro não for nulo, os sinalizadores nesta enumeração serão usados. Caso contrário, os sinalizadores especificados pelo DefaultDllImportSearchPathsAttribute no assembly de chamada, se houver, serão usados. Esse método não invoca o resolvedor registrado usando SetDllImportResolver(Assembly, DllImportResolver) o método . A partir do .NET 5, esse método invoca o AssemblyLoadContext.LoadUnmanagedDll método e o AssemblyLoadContext.ResolvingUnmanagedDll evento.