DllImportAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Gibt an, dass die attributierte Methode von einer nicht verwalteten Dynamic Link Library (DLL) als statischer Einstiegspunkt verfügbar gemacht wird.

public ref class DllImportAttribute sealed : 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)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DllImportAttribute = class
    inherit Attribute

Public NotInheritable Class DllImportAttribute
Inherits Attribute

Vererbung

Object

Attribute

DllImportAttribute

Attribute

AttributeUsageAttribute ComVisibleAttribute

Beispiele

Das folgende Codebeispiel zeigt, wie Sie das DllImportAttribute Attribut zum Importieren der Win32-Funktion MessageBox verwenden. Im Codebeispiel wird dann die importierte Methode aufgerufen.

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

Hinweise

Sie können dieses Attribut auf Methoden anwenden.

Das DllImportAttribute Attribut stellt die erforderlichen Informationen bereit, um eine Funktion aufzurufen, die aus einer nicht verwalteten DLL exportiert wird. Als Mindestanforderung müssen Sie den Namen der DLL angeben, die den Einstiegspunkt enthält.

Sie wenden dieses Attribut direkt auf C#-Methodendefinitionen an; Der Visual Basic Compiler gibt dieses Attribut jedoch aus, wenn Sie die Declare-Anweisung verwenden. Bei komplexen Methodendefinitionen, die BestFitMapping, CallingConvention, ExactSpelling, PreserveSig, SetLastError oder ThrowOnUnmappableChar-Felder enthalten, wenden Sie dieses Attribut direkt auf Visual Basic Methodendefinitionen an. Erwägen Sie stattdessen die Verwendung des LibraryImportAttribute Attributs.

Note

Dieses Attribut wird von JScript nicht unterstützt. Sie können C#- oder Visual Basic Wrapperklassen verwenden, um auf nicht verwaltete API-Methoden aus JScript-Programmen zuzugreifen.

Weitere Informationen zur Verwendung des Plattform-Aufrufdiensts für den Zugriff auf Funktionen in nicht verwalteten DLLs finden Sie unter Verwenden nicht verwalteter DLL-Funktionen.

Note

Das DllImportAttribute Marshalling von generischen Typen wird nicht unterstützt.

Konstruktoren

Name	Beschreibung
DllImportAttribute(String)	Initialisiert eine neue Instanz der DllImportAttribute Klasse mit dem Namen der DLL, die die zu importierende Methode enthält.

Felder

Name	Beschreibung
BestFitMapping	Aktiviert oder deaktiviert das optimale Zuordnungsverhalten beim Konvertieren von Unicode-Zeichen in ANSI-Zeichen.
CallingConvention	Gibt die Aufrufkonvention eines Einstiegspunkts an.
CharSet	Gibt an, wie Zeichenfolgenparameter für die Methode und steuerelemente name mangling gemarstet werden.
EntryPoint	Gibt den Namen oder die Ordnungszahl des dll-Einstiegspunkts an, der aufgerufen werden soll.
ExactSpelling	Steuert, ob das Feld bewirkt, dass die CharSet Common Language Runtime eine nicht verwaltete DLL nach anderen Einstiegspunktnamen als dem angegebenen durchsucht.
PreserveSig	Gibt an, ob nicht verwaltete Methoden mit HRESULT Rückgabewerten direkt übersetzt werden oder ob HRESULT Rückgabewerte automatisch in Ausnahmen konvertiert werden.
SetLastError	Gibt an, ob der Angerufene einen Fehler (SetLastError auf Windows oder errno auf anderen Plattformen) festlegt, bevor sie von der attributierenden Methode zurückgegeben werden.
ThrowOnUnmappableChar	Aktiviert oder deaktiviert das Auslösen einer Ausnahme für ein nicht verwendbares Unicode-Zeichen, das in ein ANSI-Zeichen "?" konvertiert wird.

Eigenschaften

Name	Beschreibung
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)
Value	Ruft den Namen der DLL-Datei ab, die den Einstiegspunkt enthält.

Methoden

Name	Beschreibung
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute)

Weitere Informationen

• SetLastError
• ExactSpelling
• PreserveSig
• CallingConvention