Поделиться через

extern (справочник по C#)

  • Статья

Модификатор extern используется для объявления метода с внешней реализацией. Когда службы взаимодействия используются для вызова неуправляемого кода, модификатор extern обычно используется с атрибутом DllImport. В этом случае также необходимо объявить метод как static в соответствии со следующим примером:

[DllImport("avifil32.dll")]
private static extern void AVIFileInit();

Примечание

Ключевое слово extern может также задавать псевдоним внешней сборки, который позволяет создавать в сборке ссылки на различные версии одного компонента.Дополнительные сведения см. в разделе Псевдоним extern (Справочник по C#).

Совместное использование модификаторов abstract (Справочник по C#) и extern для изменения одного члена является недопустимым. Использование модификатора extern указывает на то, что метод реализуется вне кода C#, а использование модификатора abstract указывает на то, что в данном классе реализация метода не предоставляется.

Примечание

Ключевое слово extern имеет более ограниченное применение по сравнению с C++.Для сравнения с ключевым словом C++ см. раздел Using extern to Specify Linkage в справочнике по языку C++.

Пример

В этом примере программа получает от пользователя строку и отображает ее в окне сообщения. В этой программе используется метод MessageBox, импортированный из библиотеки 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);
        }

    }

В этом примере из программы C создается библиотека DLL, которая вызывается из программы C# в следующем примере.

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

В этом примере для пояснения применения extern используются два файла CM.cs и Cmdll.c. Файл C является внешней библиотекой DLL, созданной в примере 2, которая вызывается из программы 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));
   }
}

Заметки

Для построения проекта выполните следующие действия:

  • Скомпилируйте Cmdll.c в библиотеку DLL, используя командную строку Visual C++:

    cl /LD Cmdll.c

  • Скомпилируйте CM.cs, используя командную строку:

    csc CM.cs

При этом будет создан исполняемый файл CM.exe. При запуске этой программы метод SampleMethod передает значение 5 в файл DLL, который возвращает это значение, помноженное на 10.

Спецификация языка C#

Дополнительные сведения см в Спецификация языка C#. Спецификация языка является предписывающим источником информации о синтаксисе и использовании языка C#.

См. также

Ссылки

Ключевые слова C#

Модификаторы (Справочник по C#)

System.Runtime.InteropServices.DllImportAttribute

Основные понятия

Руководство по программированию на C#

Другие ресурсы

Справочник по C#