Compartilhar via


extern (referência de C#)

O extern modificador é usado para declarar um método que é implementado externamente. Um uso comum do extern modificador é com o DllImport atributo quando você estiver usando os serviços de interoperabilidade para chamar código não gerenciado. Nesse caso, o método também deve ser declarado como static, conforme mostrado no exemplo a seguir:

[DllImport("avifil32.dll")]
private static extern void AVIFileInit();
ObservaçãoObservação

O extern palavra-chave também pode definir um alias de assembly externo, o que torna possível fazer referência a versões diferentes do mesmo componente de dentro de um único assembly. Para obter mais informações, consulte extern alias (referência de C#).

É um erro para usar o abstract (C# Reference) e extern modificadores juntos para modificar o mesmo membro. Usando o extern modificador significa que o método é implementado fora o código de C#, enquanto usando o abstract significa de modificador que a implementação do método não é fornecida a classe.

ObservaçãoObservação

O extern palavra-chave mais limitou usa que em C++. Para comparar com a palavra-chave do C++, consulte Using extern to Specify Linkage na referência de linguagem C++.

Exemplo

Neste exemplo, o programa recebe uma sequência do usuário e exibe-dentro de uma caixa de mensagem. O programa usa o MessageBox método importado da biblioteca user32. dll.

    //using System.Runtime.InteropServices;
    class ExternTest
    {
        [DllImport("User32.dll", CharSet=CharSet.Unicode)] 
        public static extern int MessageBox(IntPtr h, string m, string c, int type);

        static int Main()
        {
            string myString;
            Console.Write("Enter your message: ");
            myString = Console.ReadLine();
            return MessageBox((IntPtr)0, myString, "My Message Box", 0);
        }

    }

Este exemplo cria uma DLL a partir de um programa em c que é chamado de dentro do programa C# no próximo exemplo.

// cmdll.c
// Compile with: /LD
int __declspec(dllexport) SampleMethod(int i)
{
   return i*10;
}

Este exemplo usa dois arquivos, CM.cs e Cmdll.c, para demonstrar extern. O arquivo c é que a DLL externa criado no exemplo 2 que é chamado de dentro do programa C#.

// cm.cs
using System;
using System.Runtime.InteropServices;
public class MainClass 
{
   [DllImport("Cmdll.dll")]
   public static extern int SampleMethod(int x);

   static void Main() 
   {
      Console.WriteLine("SampleMethod() returns {0}.", SampleMethod(5));
   }
}
  

Comentários

Para construir o projeto:

  • Compilar Cmdll.c para uma DLL usando a linha de comando do Visual C++:

    cl /LD Cmdll.c

  • Compilar CM.cs usando a linha de comando:

    csc CM.cs

Isso criará o arquivo executável CM.exe. Quando você executa esse programa, SampleMethod passará o valor 5 para o arquivo DLL, que retorna o valor multiplicado por 10.

Especificação da linguagem C#

Para obter mais informações, consulte C# Language Specification A especificação de linguagem é a fonte definitiva para a sintaxe e o uso de C#.

Consulte também

Referência

C# Keywords

Modifiers (C# Reference)

System.Runtime.InteropServices.DllImportAttribute

Conceitos

C# Programming Guide

Outros recursos

C# Reference