DllImportAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Quelle:

DllImportAttribute.cs

Gibt an, dass die attributierte Methode durch eine nicht verwaltete Dynamic Link Library (DLL) als statischer Einstiegspunkt verfügbar gemacht wird.

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

Vererbung

Object

Attribute

DllImportAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Codebeispiel zeigt, wie Sie das DllImportAttribute -Attribut verwenden, um die Win32-Funktion MessageBox zu importieren. 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 Informationen bereit, die zum Aufrufen einer Funktion erforderlich sind, die aus einer nicht verwalteten DLL exportiert wurde. Als Mindestanforderung müssen Sie den Namen der DLL angeben, die den Einstiegspunkt enthält.

Sie wenden dieses Attribut direkt auf C#- und C++-Methodendefinitionen an. Der Visual Basic-Compiler gibt dieses Attribut jedoch aus, wenn Sie die Declare -Anweisung verwenden. Bei komplexen Methodendefinitionen, die Felder , ExactSpellingCallingConvention, PreserveSig, , SetLastErroroder ThrowOnUnmappableChar enthaltenBestFitMapping, wenden Sie dieses Attribut direkt auf Visual Basic-Methodendefinitionen an.

Hinweis JScript unterstützt dieses Attribut nicht. Sie können C#- oder Visual Basic-Wrapperklassen verwenden, um über JScript-Programme auf nicht verwaltete API-Methoden zuzugreifen.

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

Hinweis

das DllImportAttribute Marshalling generischer Typen nicht unterstützt.

Konstruktoren

DllImportAttribute(String)

Initialisiert eine neue Instanz der DllImportAttribute-Klasse mit dem Namen der DLL, die die zu importierende Methode enthält.

Felder

BestFitMapping	Aktiviert bzw. deaktiviert das Verhalten der optimalen Zuordnung bei der Konvertierung von Unicode-Zeichen in ANSI-Zeichen.
CallingConvention	Gibt die Aufrufkonvention eines Einstiegspunkts an.
CharSet	Gibt an, wie Zeichenfolgenparameter an die Methode gemarshallt werden, und steuert die Namenszerlegung.
EntryPoint	Gibt den Namen oder die Ordnungszahl des aufzurufenden DLL-Einstiegspunkts an.
ExactSpelling	Steuert, ob das CharSet-Feld die Common Language Runtime anweist, eine nicht verwaltete DLL nach anderen Einstiegspunktnamen als dem angegebenen zu durchsuchen.
PreserveSig	Gibt an, ob nicht verwaltete Methoden, die Rückgabewerte aufweisen HRESULT , direkt übersetzt werden oder ob HRESULT Rückgabewerte automatisch in Ausnahmen konvertiert werden.
SetLastError	Gibt an, ob der Aufgerufene einen Fehler (SetLastError unter Windows oder errno auf anderen Plattformen) festlegt, bevor er von der attributierten Methode zurückgibt.
ThrowOnUnmappableChar	Aktiviert bzw. deaktiviert das Auslösen einer Ausnahme bei einem nicht zuzuordnenden Unicode-Zeichen, das in das ANSI-Zeichen „?“ konvertiert wird.

Eigenschaften

TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
Value	Ruft den Namen der DLL-Datei ab, die den Einstiegspunkt enthält.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• SetLastError
• ExactSpelling
• PreserveSig
• CallingConvention