Udostępnij za pośrednictwem


DllImportAttribute Klasa

Definicja

Wskazuje, że metoda przypisana jest uwidoczniona przez niezarządzaną bibliotekę dynamicznego łącza (DLL) jako statyczny punkt wejścia.

public ref class DllImportAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class DllImportAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DllImportAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type DllImportAttribute = class
    inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DllImportAttribute = class
    inherit Attribute
Public NotInheritable Class DllImportAttribute
Inherits Attribute
Dziedziczenie
DllImportAttribute
Atrybuty

Przykłady

Poniższy przykład kodu pokazuje, jak użyć atrybutu DllImportAttribute do zaimportowania funkcji Win32 MessageBox . Przykładowy kod wywołuje następnie zaimportowaną metodę.

using System;
using System.Runtime.InteropServices;

class Example
{
    // Use DllImport to import the Win32 MessageBox function.
    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    public static extern int MessageBox(IntPtr hWnd, String text, String caption, uint type);
    
    static void Main()
    {
        // Call the MessageBox function using platform invoke.
        MessageBox(new IntPtr(0), "Hello World!", "Hello Dialog", 0);
    }
}
Imports System.Runtime.InteropServices

Module Example

    ' Use DllImport to import the Win32 MessageBox function.
    <DllImport("user32.dll", CharSet:=CharSet.Unicode)> _
    Function MessageBox(ByVal hwnd As IntPtr, ByVal t As String, ByVal caption As String, ByVal t2 As UInt32) As Integer
    End Function


    Sub Main()
        ' Call the MessageBox function using platform invoke.
        MessageBox(New IntPtr(0), "Hello World!", "Hello Dialog", 0)
    End Sub

End Module

Uwagi

Ten atrybut można zastosować do metod.

Atrybut DllImportAttribute zawiera informacje potrzebne do wywołania funkcji wyeksportowanej z niezarządzanej biblioteki DLL. Jako minimalne wymaganie należy podać nazwę biblioteki DLL zawierającej punkt wejścia.

Ten atrybut jest stosowany bezpośrednio do definicji metod C# i C++; jednak kompilator języka Visual Basic emituje ten atrybut podczas korzystania z instrukcji Declare . W przypadku złożonych definicji metod obejmujących BestFitMappingpola , CallingConvention, ExactSpelling, PreserveSig, SetLastErrorlub ThrowOnUnmappableChar ten atrybut jest stosowany bezpośrednio do definicji metod języka Visual Basic.

Uwaga Język JScript nie obsługuje tego atrybutu. Klasy otoki języka C# lub Visual Basic umożliwiają dostęp do niezarządzanych metod interfejsu API z poziomu programów JScript.

Aby uzyskać dodatkowe informacje na temat używania usługi wywoływania platformy do uzyskiwania dostępu do funkcji w niezarządzanych bibliotekach DLL, zobacz Korzystanie z niezarządzanych funkcji DLL.

Uwaga

Funkcja DllImportAttribute nie obsługuje marshalingu typów ogólnych.

Konstruktory

DllImportAttribute(String)

Inicjuje DllImportAttribute nowe wystąpienie klasy o nazwie biblioteki DLL zawierającej metodę do zaimportowania.

Pola

BestFitMapping

Włącza lub wyłącza zachowanie mapowania najlepiej dopasowane podczas konwertowania znaków Unicode na znaki ANSI.

CallingConvention

Wskazuje konwencję wywoływania punktu wejścia.

CharSet

Wskazuje sposób marshalingu parametrów ciągu do metody i kontrolek nazw mangling.

EntryPoint

Wskazuje nazwę lub liczbę porządkową punktu wejścia biblioteki DLL do wywołania.

ExactSpelling

Określa, CharSet czy pole powoduje, że środowisko uruchomieniowe języka wspólnego wyszukuje niezarządzaną bibliotekę DLL dla nazw punktów wejścia innych niż określona.

PreserveSig

Wskazuje, czy niezarządzane metody, które mają HRESULT zwracane wartości, są tłumaczone bezpośrednio, czy HRESULT zwracane wartości są automatycznie konwertowane na wyjątki.

SetLastError

Wskazuje, czy obiekt wywoływany ustawia błąd (SetLastError w systemie Windows lub errno na innych platformach) przed powrotem z metody przypisanej.

ThrowOnUnmappableChar

Włącza lub wyłącza zgłaszanie wyjątku dla nieaplikowanego znaku Unicode konwertowanego na znak ANSI "?".

Właściwości

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu .

(Odziedziczone po Attribute)
Value

Pobiera nazwę pliku DLL zawierającego punkt wejścia.

Metody

Equals(Object)

Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi.

(Odziedziczone po Attribute)
GetHashCode()

Zwraca wartość skrótu dla tego wystąpienia.

(Odziedziczone po Attribute)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
IsDefaultAttribute()

Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej.

(Odziedziczone po Attribute)
Match(Object)

Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też