DllImportAttribute(String) Construtor

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

DllImportAttribute.cs

Inicializa uma nova instância da classe DllImportAttribute com o nome da DLL que contém o método a ser importado.

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)

Parâmetros

dllName

String

O nome da DLL que contém o método não gerenciado. Em .NET Framework, isso poderá incluir um nome de exibição de assembly, se a DLL estiver incluída em um assembly.

Exemplos

O exemplo de código a seguir mostra como usar o DllImportAttribute atributo para importar a função Win32 MessageBox . Em seguida, o exemplo de código chama o método importado.

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

Comentários

.NET Framework somente: se um arquivo DLL não gerenciado estiver incluído em um assembly, por exemplo, usando o vinculador ou a opção do /linkresource compilador, você poderá especificar o nome de exibição do assembly como parte de dllName. Por exemplo, se uma DLL não gerenciada chamada unmanaged.dll for incluída em um assembly gerenciado chamado MyAssembly, o atributo poderá ser especificado conforme mostrado no código a seguir.

[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