Пошаговое руководство. Создание и использование библиотеки DLL (C++)

Статья
08/11/2011

Сперва мы создадим библиотеку динамической компоновки (DLL). Библиотеки DLL являются хорошим способом повторного использования кода. Вместо того чтобы каждый раз реализовывать одни и те же подпрограммы в каждом создаваемом приложении, их можно создать единожды и затем вызывать из приложений для обеспечения соответствующей функциональности.

В этом пошаговом руководстве рассматриваются следующие действия:

создание проекта библиотеки динамической компоновки (DLL);
добавление класса в библиотеку динамической компоновки;
создание приложения, ссылающегося на библиотеку динамической компоновки;
использование функциональных возможностей библиотеки классов в консольном приложении;
запуск приложения.

Обязательные компоненты

Этот раздел предполагает знание основ языка C++. Если вы приступаете к изучению C++, рекомендуем вам "Руководство по С++ для начинающих", написанное Гербом Шилдтом (Herb Schildt), которое доступно по ссылке https://go.microsoft.com/fwlink/?LinkId=115303.

Создание проекта библиотеки динамической компоновки (DLL)

В меню Файл выберите пункт Создать и затем пункт Проект....
В узле Visual C++ области Типы проектов выберите Win32.
В области Шаблоны выберите Консольное приложение Win32.
Выберите имя проекта, например MathFuncsDll, и введите его в поле Имя. Выберите имя решения, например DynamicLibrary, и введите его в поле Имя решения.
Для запуска мастера приложений Win32 нажмите кнопку ОК. На странице Общие сведения диалогового окна Мастер приложений Win32 нажмите кнопку Далее.
На странице Параметры приложения диалогового окна Мастер приложений Win32, в поле Тип приложения, выберите пункт DLL, если он доступен, либо пункт Консольное приложение, если пункт DLL не доступен. В некоторых версиях Visual Studio создание проектов DLL с помощью мастеров не поддерживается. Необходимые изменения можно внести позднее для компиляции проекта в библиотеку DLL.
На странице Параметры приложения диалогового окна Мастер приложений Win32 в поле Дополнительные параметры выберите пункт Пустой проект.
Чтобы создать проект, нажмите кнопку Готово.

Добавление класса в библиотеку динамической компоновки

Чтобы создать файл заголовка для нового класса, в меню Проект выберите команду Добавить новый элемент.... Откроется диалоговое окно Добавление нового элемента. В узле Visual C++ области Категории выберите пункт Код. В области Шаблоны выберите пункт Заголовочный файл (.h). Выберите имя файла заголовка, например MathFuncsDll.h, и нажмите кнопку Добавить. Отобразится пустой файл.

Добавьте простой класс с именем MyMathFuncs, осуществляющий обычные арифметические операции, такие как сложение, вычитание, умножение и деление. Код должен выглядеть примерно следующим образом:

// MathFuncsDll.h

namespace MathFuncs
{
    class MyMathFuncs
    {
    public:
        // Returns a + b
        static __declspec(dllexport) double Add(double a, double b);

        // Returns a - b
        static __declspec(dllexport) double Subtract(double a, double b);

        // Returns a * b
        static __declspec(dllexport) double Multiply(double a, double b);

        // Returns a / b
        // Throws DivideByZeroException if b is 0
        static __declspec(dllexport) double Divide(double a, double b);
    };
}

Обратите внимание на модификатор __declspec(dllexport) в объявлениях методов в этом коде. Этот модификатор разрешает экспорт метода библиотекой DLL для использования его другими приложениями. Дополнительные сведения см. в разделе dllexport, dllimport.
Чтобы создать исходный файл для нового класса, в меню Проект выберите команду Добавить новый элемент.... Откроется диалоговое окно Добавление нового элемента. В узле Visual C++ области Категории выберите пункт Код. В области Шаблоны выберите пункт Файл C++ (.cpp). Выберите имя исходного файла, например MathFuncsDll.cpp, и нажмите кнопку Добавить. Отобразится пустой файл.

Реализуйте функциональность класса MyMathFuncs в исходном файле. Код должен выглядеть примерно следующим образом:

// MathFuncsDll.cpp
// compile with: /EHsc /LD

#include "MathFuncsDll.h"

#include <stdexcept>

using namespace std;

namespace MathFuncs
{
    double MyMathFuncs::Add(double a, double b)
    {
        return a + b;
    }

    double MyMathFuncs::Subtract(double a, double b)
    {
        return a - b;
    }

    double MyMathFuncs::Multiply(double a, double b)
    {
        return a * b;
    }

    double MyMathFuncs::Divide(double a, double b)
    {
        if (b == 0)
        {
            throw new invalid_argument("b cannot be zero!");
        }

        return a / b;
    }
}

Чтобы построить библиотеку DLL проекта, в меню Проект выберите Свойства MathFuncsDll. В левой области в поле Свойства конфигурации выберите Общие. В правой области в поле Тип конфигурации выберите Динамическая библиотека (.dll). Нажмите кнопку ОК для сохранения изменений.

Примечание

При построении проекта из командной строки используйте параметр компилятора /LD, указывающий на то, что выходной файл должен являться DLL-файлом.Дополнительные сведения см. в разделе /MD, /MT, /LD (использование библиотеки времени выполнения).
Скомпилируйте библиотеку динамической компоновки, выбрав команду Построить решение в меню Построение. В результате будет создана библиотека DLL, которая может использоваться другими программами. Дополнительные сведения о библиотеках DLL см. в разделе библиотеки DLL.

Создание приложения, ссылающегося на библиотеку динамической компоновки

Чтобы создать приложение, которое будет ссылаться и использовать созданную ранее библиотеку динамической компоновки, в меню Файл выберите пункт Создать и затем пункт Проект....
В узле Visual C++ области Типы проектов выберите Win32.
В области Шаблоны выберите Консольное приложение Win32.
Выберите имя проекта, например MyExecRefsDll, и введите его в поле Имя. В раскрывающемся списке рядом с полем Решение выберите пункт Добавить в решение. После этого новый проект будет добавлен в то же решение, что и библиотека динамической компоновки.
Для запуска мастера приложений Win32 нажмите кнопку ОК. На странице Общие сведения диалогового окна Мастер приложений Win32 нажмите кнопку Далее.
На странице Параметры приложения диалогового окна Мастер приложений Win32 в поле Тип приложения выберите пункт Консольное приложение.
На странице Параметры приложения диалогового окна Мастер приложений Win32 в поле Дополнительные параметры снимите флажок Предкомпилированный заголовок.
Чтобы создать проект, нажмите кнопку Готово.

Использование функциональных возможностей библиотеки классов в консольном приложении

По завершении создания консольного приложения будет создана пустая программа. Имя исходного файла будет совпадать с именем, выбранным ранее для проекта. В этом примере он имеет имя MyExecRefsDll.cpp.
Для использования математических процедур из библиотеки динамической компоновки необходимо сослаться на эту библиотеку. Для этого в обозревателе решений выберите проект MyExecRefsDll и затем выберите Ссылки… в меню Проект. В диалоговом окне Страницы свойств разверните узел Общие свойства, выберите пункт .NET Framework и ссылки и затем нажмите кнопку Добавить новую ссылку…. Дополнительные сведения о диалоговом окне Ссылки... см. в разделе Среда и ссылки, общие свойства и диалоговое окно "Страницы свойств: <Имя проекта>".
Появится диалоговое окно Добавление ссылки. В этом диалоговом окне отображается список всех библиотек, на которые можно ссылаться. На вкладке Проект перечисляются все проекты текущего решения и включенные в них библиотеки. На вкладке Проекты выберите MathFuncsDll. Затем нажмите кнопку ОК.
Для создания ссылки на заголовочные файлы библиотеки динамической компоновки необходимо изменить путь к каталогам включения. Для этого в диалоговом окне Окна свойств последовательно разверните узлы Свойства конфигурации, C/C++, а затем выберите Общие. Рядом с полем Дополнительные каталоги включения введите путь к месту размещения файла заголовков MathFuncsDll.h.
Исполняемый файл не загружает библиотеки динамической компоновки во время выполнения. Необходимо указать системе место для поиска библиотеки MathFuncsDll.dll. Это можно сделать с помощью переменной среды PATH. Для этого в диалоговом окне Окна свойств разверните узел Свойства конфигурации, а затем выберите Отладка. В поле Среда введите следующую строку: PATH=<путь_к_файлу_MathFuncsDll.dll>, где вместо <путь_к_файлу_MathFuncsDll.dll> необходимо подставить фактическое расположение библиотеки MathFuncsDll.dll. Нажмите кнопку ОК для сохранения всех изменений.

Примечание

При использовании для запуска исполняемого файла командной строки вместо Visual Studio необходимо вручную обновить переменную среды PATH из командной строки следующим образом: set PATH=%PATH%;<путь_к_файлу_MathFuncsDll.dll>, где вместо <путь_к_файлу_MathFuncsDll.dll> необходимо подставить фактическое расположение библиотеки MathFuncsDll.dll.

Теперь класс MyMathFuncs можно использовать в приложении. Замените код в файле MyExecRefsDll.cpp следующим кодом:

// MyExecRefsDll.cpp
// compile with: /EHsc /link MathFuncsDll.lib

#include <iostream>

#include "MathFuncsDll.h"

using namespace std;

int main()
{
    double a = 7.4;
    int b = 99;

    cout << "a + b = " <<
        MathFuncs::MyMathFuncs::Add(a, b) << endl;
    cout << "a - b = " <<
        MathFuncs::MyMathFuncs::Subtract(a, b) << endl;
    cout << "a * b = " <<
        MathFuncs::MyMathFuncs::Multiply(a, b) << endl;
    cout << "a / b = " <<
        MathFuncs::MyMathFuncs::Divide(a, b) << endl;

    return 0;
}

Постройте исполняемый файл, выбрав команду Построить решение в меню Построение.

Запуск приложения

Убедитесь, что проект MyExecRefsDll выбран в качестве проекта по умолчанию. В Обозревателе решений выберите проект MyExecRefsDll и затем в меню Проект выберите команду Назначить запускаемым проектом.
Чтобы запустить проект, в меню Отладка выберите команду Запуск без отладки. Результат выполнения должен выглядеть примерно следующим образом:
```
a + b = 106.4
a - b = -91.6
a * b = 732.6
a / b = 0.0747475
```

Следующие действия

Назад: Создание повторно используемого кода (C++) | Далее: Пошаговое руководство. Создание и использование статической библиотеки (C++)

См. также

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

Пошаговое руководство. Создание и использование библиотеки DLL (C++)

Обязательные компоненты

Создание проекта библиотеки динамической компоновки (DLL)

Добавление класса в библиотеку динамической компоновки

Создание приложения, ссылающегося на библиотеку динамической компоновки

Использование функциональных возможностей библиотеки классов в консольном приложении

Запуск приложения

Следующие действия

См. также

Задачи

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

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

Дополнительные ресурсы