此分步演练演示如何创建用于 C++ 应用程序的动态链接库 (DLL)。 使用库是重用代码的一种绝佳方式。 您不必在自己创建的每个程序中重新实现同一例程,而只需对这些例程写入一次,然后从需要该功能的应用程序引用它们即可。 通过将代码放入 DLL,您节省在引用它的每个应用程序的空间,而且,您可以更新 DLL,而无需重新编译所有应用程序。 有关 DLL 的详细信息,请参见 Visual C++ 中的 DLL。
本演练涵盖以下任务:
-
创建 DLL 项目。
-
添加类至 DLL。
-
正在创建使用加载时动态链接对 DLL 进行引用的控制台应用程序。
-
在应用程序中使用类的功能。
-
运行应用程序。
本演练可创建只能从使用了 C++ 调用约定的应用程序中调用的 DLL。 有关如何为使用其他语言创建 DLL 的信息,请参见 从 Visual Basic 应用程序调用 DLL 函数。
创建动态链接库 (DLL) 项目
-
在菜单栏上,选择“文件”,“新建、“项目”。
-
在“新建项目”对话框左窗格中,展开“已安装”、“模板”、“Visual C++”,然后选择“Win32”。
-
在中间窗格中,选择“Win32 控制台应用程序”。
-
在“名称”框中为项目指定名称,例如,MathFuncsDll。 在“解决方案名称”框中为解决方案指定一个名称,例如 DynamicLibrary。 选择“确定”按钮。
-
在“Win32 应用程序向导”对话框的“概述”页上,选择“下一步”按钮。
-
在“应用程序设置”页上的“应用程序类型”下,选择“DLL”。
-
选择“完成”按钮创建项目。
向动态链接库添加类
-
若要为新类创建头文件,在菜单栏上依次选择“项目”、“添加新项...”。 在“添加新项”对话框中,在左窗格的“Visual C++”下,选择“代码”。 在中心窗格中,选择“头文件 (.h)”。 为头文件指定一个名称,例如 MathFuncsDll.h,然后选择“添加”按钮。 将显示一个空白头文件。
-
添加下列代码至头文件的开头:
// MathFuncsDll.h #ifdef MATHFUNCSDLL_EXPORTS #define MATHFUNCSDLL_API __declspec(dllexport) #else #define MATHFUNCSDLL_API __declspec(dllimport) #endif
-
添加一个名为“MyMathFuncs”的基础类,以执行常见的算术运算,如加、减、乘和除。 代码应类似如下:
namespace MathFuncs { // This class is exported from the MathFuncsDll.dll class MyMathFuncs { public: // Returns a + b static MATHFUNCSDLL_API double Add(double a, double b); // Returns a - b static MATHFUNCSDLL_API double Subtract(double a, double b); // Returns a * b static MATHFUNCSDLL_API double Multiply(double a, double b); // Returns a / b // Throws const std::invalid_argument& if b is 0 static MATHFUNCSDLL_API double Divide(double a, double b); }; }
当定义了 MATHFUNCSDLL_EXPORTS 符号时,MATHFUNCSDLL_API 符号将在此代码中的成员函数声明中设置 __declspec(dllexport) 修饰符。 此修饰符使函数能作为 DLL 导出,以供其他应用程序调用。 当 MATHFUNCSDLL_EXPORTS 未定义时,MATHFUNCSDLL_API 会在成员函数声明中定义 __declspec(dllimport) 修饰符。此修饰符能够使编译器优化从 DLL 导入的用于其他应用程序的函数。 默认情况下,生成 MathFuncsDll 项目时会定义 MATHFUNCSDLL_EXPORTS。 有关详细信息,请参阅 dllexport、dllimport。
说明 如果正在命令行上生成 DLL 项目,则使用 /D 编译器选项来定义 MATHFUNCSDLL_EXPORTS 符号。
-
在“解决方案资源管理器”的“MathFuncsDll”项目中,在“源文件”文件夹中,打开“MathFuncsDll.cpp”。
-
在源文件中实现 MyMathFuncs 的功能。 代码应类似如下:
// MathFuncsDll.cpp : Defines the exported functions for the DLL application. // #include "stdafx.h" #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 invalid_argument("b cannot be zero!"); } return a / b; } }
-
通过选择菜单栏中的 生成>生成解决方案 编译动态链接库
说明 如果您正在使用不显示“生成”菜单的学习版,则在菜单栏上选择“工具”、“设置”、“专家设置”来启用它,然后选择“生成”,“生成解决方案”。
说明 如果在命令行中生成项目,请使用 /LD 编译器选项指定输出文件为 DLL。 有关详细信息,请参阅 /MD、/MT、/LD(使用运行库)。 使用 /EHsc 编译器选项启用 C++ 异常处理。 有关详细信息,请参阅 /EH(异常处理模型)。
若要创建引用 DLL 的应用程序
-
为了创建一个项目引用你刚刚创建好的DLL,在菜单栏中选择 文件>新建>项目。
-
在左窗格中的“Visual C++”下,选择“Win32”。
-
在中间窗格中,选择“Win32 控制台应用程序”。
-
在“名称”框中为项目指定名称,例如,MyExecRefsDll。 从“解决方案”旁边的下拉列表中选择“添加到解决方案”。 这会将新项目添加到包含 DLL 的同一个解决方案中。 选择“确定”按钮。
-
在“Win32 应用程序向导”对话框的“概述”页上,选择“下一步”按钮。
-
在“应用程序设置”页上的“应用程序类型”下,选择“控制台应用程序”。
-
在“应用程序设置”页上的“附加选项”下,清除“预编译头”复选框。
-
选择“完成”按钮创建项目。
在应用程序中使用类库的功能
-
在创建一个控制台应用程序后,一个空的程序已经为你创建好了。 源文件的名称与您之前选择的名称相同。 在本示例中,名为“MyExecRefsDll.cpp”。
-
若要使用您 DLL 中创建的算术例程,必须引用 DLL。 为此,请在 解决方案资源管理器 中选择 MyExecRefsDll 项目,然后在菜单栏上,选择 项目,引用。 在“属性页”对话框中,展开“通用属性”节点,选择“框架和引用”,然后选择“添加新引用”按钮。 有关“引用”对话框的更多信息,请参见“<Projectname> 属性页”对话框 ->“通用属性”->“框架和引用”。
-
“添加引用”对话框列出了可以引用的库。 “项目”选项卡列出了当前解决方案中的所有项目,以及它们包含的所有库。 在“项目”选项卡上,选中“MathFuncsDll”旁边的复选框,然后选中“确定”按钮。
-
若要引用 DLL 的头文件,必须修改包含的目录路径。 为此,请在“属性页”对话框中展开“配置属性”节点,然后展开“C/C++”节点,并选择“常规”。 在“附加包含目录”旁边,指定 MathFuncsDll.h 头文件所在位置的路径。 可以使用相对路径(例如 ..\MathFuncsDll\),然后选择“确定”按钮。
-
现在即可在此应用程序中使用 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; try { cout << "a / 0 = " << MathFuncs::MyMathFuncs::Divide(a, 0) << endl; } catch (const invalid_argument &e) { cout << "Caught exception: " << e.what() << endl; } return 0; }
-
通过在菜单上栏上依次选择“生成”、“生成解决方案”来生成可执行文件。
运行应用程序
-
确保选择“MyExecRefsDll”作为默认项目。 在“解决方案资源管理器”中,选择 MyExecRefsDll,然后在菜单栏上依次选择“项目”、“设为启动项目”。
-
若要运行项目,请在菜单栏上依次选择“调试”、“开始执行(不调试)”。 输出应该与下面的内容类似:
a + b = 106.4 a - b = -91.6 a * b = 732.6 a / b = 0.0747475 捕获异常: b 不能为零 !