DllImportAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestawy:

netstandard.dll, System.Runtime.InteropServices.dll

Źródło:

DllImportAttribute.cs

Wskazuje, że metoda przypisana jest uwidoczniona przez niezarządzaną bibliotekę łącza dynamicznego (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)>]
type DllImportAttribute = class
    inherit Attribute

Public NotInheritable Class DllImportAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

DllImportAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

Poniższy przykład kodu przedstawia sposób użycia atrybutu DllImportAttribute do zaimportowania funkcji Win32 MessageBox . Przykładowy kod wywołuje 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 języka C#; jednak kompilator Visual Basic emituje ten atrybut podczas korzystania z instrukcji Declare. W przypadku złożonych definicji metod, które obejmują BestFitMapping, CallingConvention, ExactSpelling, PreserveSig, SetLastError lub ThrowOnUnmappableChar pola, należy zastosować ten atrybut bezpośrednio do definicji metody Visual Basic. Rozważ użycie atrybutu LibraryImportAttribute zamiast tego.

Note

Język JScript nie obsługuje tego atrybutu. Klas otoki języka C# lub Visual Basic można używać do uzyskiwania dostępu 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.

Note

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

Konstruktory

Nazwa	Opis
DllImportAttribute(String)	Inicjuje nowe wystąpienie DllImportAttribute klasy o nazwie biblioteki DLL zawierającej metodę do zaimportowania.

Pola

Nazwa	Opis
BestFitMapping	Włącza lub wyłącza najlepsze zachowanie mapowania 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 nazwy mangling.
EntryPoint	Wskazuje nazwę lub porządkową punktu wejścia biblioteki DLL, który ma być wywoływany.
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ą bezpośrednio tłumaczone, czy HRESULT zwracane wartości są automatycznie konwertowane na wyjątki.
SetLastError	Wskazuje, czy obiekt wywoływany ustawia błąd (SetLastError na Windows lub errno na innych platformach) przed powrotem z metody przypisanej.
ThrowOnUnmappableChar	Włącza lub wyłącza zgłaszanie wyjątku dla niezastosowanego znaku Unicode konwertowanego na znak ANSI "?".

Właściwości

Nazwa	Opis
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute)
Value	Pobiera nazwę pliku DLL zawierającego punkt wejścia.

Metody

Nazwa	Opis
Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po zastąpieniu 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 Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• SetLastError
• ExactSpelling
• PreserveSig
• CallingConvention