DllImportAttribute(String) Konstruktor
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Inicjuje DllImportAttribute nowe wystąpienie klasy o nazwie biblioteki DLL zawierającej metodę do zaimportowania.
public:
DllImportAttribute(System::String ^ dllName);
public DllImportAttribute (string dllName);
new System.Runtime.InteropServices.DllImportAttribute : string -> System.Runtime.InteropServices.DllImportAttribute
Public Sub New (dllName As String)
Parametry
- dllName
- String
Nazwa biblioteki DLL, która zawiera metodę niezarządzaną. W programie .NET Framework może to zawierać nazwę wyświetlaną zestawu, jeśli biblioteka DLL jest zawarta w zestawie.
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
Tylko program .NET Framework: Jeśli niezarządzany plik DLL znajduje się w zestawie, na przykład przy użyciu konsolidatora lub /linkresource
opcji kompilatora, możesz określić nazwę wyświetlaną zestawu w ramach elementu dllName
. Jeśli na przykład niezarządzana biblioteka DLL o nazwie unmanaged.dll
znajduje się w zarządzanym zestawie o nazwie MyAssembly
, atrybut może zostać określony, jak pokazano w poniższym kodzie.
[DllImport("unmanaged.dll, MyAssembly, Version= 1.0.0.0,"
"Culture=neutral, PublicKeyToken=a77e0ba5eab10125")]
int SomeFuncion1(int parm);
[DllImport("unmanaged.dll, MyAssembly, Version= 1.0.0.0," +
"Culture=neutral, PublicKeyToken=a77e0ba5eab10125")]
internal static extern int SomeFuncion1(int parm);
<DllImport("unmanaged.dll, MyAssembly, Version= 1.0.0.0," +
"Culture=neutral, PublicKeyToken=a77e0ba5eab10125")>
Friend Shared Function DummyFuncion1(parm As Integer) As Integer
End Function