NativeLibrary.Load Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Aşırı Yüklemeler

Load(String)	İşletim sistemi yükleyicisini sarmalayan ve varsayılan bayrakları kullanan bir yerel kitaplık yüklemek için basit bir API sağlar.
Load(String, Assembly, Nullable<DllImportSearchPath>)	Yerel kitaplığı yüklemek için üst düzey bir API sağlar.

Load(String)

Kaynak:

NativeLibrary.cs

İşletim sistemi yükleyicisini sarmalayan ve varsayılan bayrakları kullanan bir yerel kitaplık yüklemek için basit bir API sağlar.

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

Parametreler

libraryPath

String

Yüklenecek yerel kitaplığın adı.

Döndürülenler

IntPtr

nativeint

Yüklenen yerel kitaplığın işletim sistemi tanıtıcısı.

Özel durumlar

ArgumentNullException

libraryPath, null değeridir.

DllNotFoundException

Kitaplık bulunamıyor.

BadImageFormatException

Kitaplık geçerli değil.

Load(String, Assembly, Nullable<DllImportSearchPath>)

Kaynak:

NativeLibrary.cs

Yerel kitaplığı yüklemek için üst düzey bir API sağlar.

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

Parametreler

libraryName

String

Yüklenecek yerel kitaplığın adı.

assembly

Assembly

Yerel kitaplığı yüken derleme.

searchPath

Nullable<DllImportSearchPath>

Arama yolu.

Döndürülenler

IntPtr

nativeint

Yüklenen kitaplığın işletim sistemi tanıtıcısı.

Özel durumlar

ArgumentNullException

libraryName veya assembly şeklindedir null.

ArgumentException

assembly bir RuntimeAssemblydeğildir.

DllNotFoundException

Kitaplık bulunamıyor.

BadImageFormatException

Kitaplık geçerli değil.

Açıklamalar

Bir kitaplık adı verüldüğünde, bu yöntem çalışma zamanı yapılandırmasına, giriş parametrelerine ve çağıran derlemenin özniteliklerine göre belirli yolları arar. searchPath Parametre null değilse, bu numaralandırmadaki bayraklar kullanılır. Aksi takdirde, varsa çağıran derlemede tarafından DefaultDllImportSearchPathsAttribute belirtilen bayraklar kullanılır. Bu yöntem, yöntemi kullanılarak SetDllImportResolver(Assembly, DllImportResolver) kaydedilen çözümleyiciyi çağırmaz. .NET 5'den başlayarak, bu yöntem yöntemini ve AssemblyLoadContext.ResolvingUnmanagedDll olayını çağırırAssemblyLoadContext.LoadUnmanagedDll.