DllImportAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Źródło:

DllImportAttribute.cs

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)>]
type DllImportAttribute = class
    inherit Attribute

Public NotInheritable Class DllImportAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

DllImportAttribute

Atrybuty

AttributeUsageAttribute

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)

Zobacz też

• SetLastError
• ExactSpelling
• PreserveSig
• CallingConvention