Construtor DllImportAttribute (String)

Artigo
04/18/2018

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)

Sintaxe

public DllImportAttribute(
    string dllName
)

public:
DllImportAttribute(
    String^ dllName
)

new : 
        dllName:string -> DllImportAttribute

Public Sub New (
    dllName As String
)

Parâmetros

dllName
Type: System.String

O nome da DLL que contém o método não gerenciado. Isso pode incluir um nome de exibição do assembly se a DLL estiver incluída em um assembly.

Comentários

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

[DllImport("unmanaged.dll, MyAssembly, Version= 1.0.0.0," +
 "Culture=neutral, PublicKeyToken=a77e0ba5eab10125")]
static extern int SomeFuncion1(int parm);

<DllImport("unmanaged.dll, MyAssembly, Version= 1.0.0.0," + _
 "Culture=neutral, PublicKeyToken=a77e0ba5eab10125")> _
Public Shared Function DummyFuncion1(parm As Integer) As Integer
End Function

[DllImport("unmanaged.dll, MyAssembly, Version= 1.0.0.0,"
 "Culture=neutral, PublicKeyToken=a77e0ba5eab10125")]
int SomeFuncion1(int parm);

Exemplos

O exemplo de código a seguir mostra como usar o DllImportAttribute atributo para importar o Win32 MessageBox função. O exemplo de código, em seguida, 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
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

Informações de Versão

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

Confira Também

Classe DllImportAttribute
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via