在 Visual Studio 中调试 DLL 项目（C#、C++、Visual Basic、F#）

  • 项目

DLL （动态链接库） 是包含可被多个程序使用的代码和数据的库。 你可以使用 Visual Studio 创建、 构建、 配置和调试 DLL。

创建 DLL

以下 Visual Studio 项目模板可以创建 DLL：

  • C#、Visual Basic 或 F# 类库
  • C# 或 Visual Basic Windows 窗体控件 (WCF) 库
  • C++ 动态链接库 (DLL)

有关详细信息，请参见 MFC 调试技术。

调试 WCF 库类似于调试类库。 有关详细信息，请参阅 Windows 窗体控件。

通常会从另一个项目调用 DLL。 调试调用项目时，根据 DLL 配置，可以单步跟踪和调试 DLL 代码。

DLL 调试配置

使用 Visual Studio 项目模板创建应用时，Visual Studio 会自动为调试和发布生成配置创建所需的设置。 如果需要，可以更改这些设置。 有关详细信息，请参阅以下文章：

设置 C++ DebuggableAttribute

若要使调试器附加到 C++ DLL，C++ 代码必须发出 DebuggableAttribute。

若要设置 DebuggableAttribute，请执行以下操作：

  1. 在“解决方案资源管理器”中选择该 C++ DLL 项目，然后选择“属性”图标，或右键单击该项目并选择“属性” 。

  2. 在“属性”窗格中的“链接器”>“调试”下，对“可调试程序集”选择“是(/ASSEMBLYDEBUG)”。

有关详细信息，请参阅 /ASSEMBLYDEBUG。

设置 C/C++ DLL 文件位置

若要调试外部 DLL，调用项目必须能够找到该 DLL、其 .pdb 文件 和 DLL 需要的任何其他文件。 可以创建自定义生成任务，以将这些文件复制到 <项目文件夹>\Debug 输出文件夹，也可以手动将文件复制到其中。

对于 C/C++ 项目，可以在项目属性页中设置标头和 LIB 文件位置，而不必将其复制到输出文件夹。

若要设置 C/C++ 标头和 LIB 文件位置：

  1. 在解决方案资源管理器中选择该 C/C++ DLL 项目，然后选择属性图标，或右键单击该项目并选择属性。

  2. 在“属性”窗格顶部的“配置”下，选择“所有配置”。

  3. 在 C/C++>常规>附加包含目录 中，指定具有标头文件的文件夹。

  4. 在 链接器>常规>附加库目录 中，指定具有 LIB 文件的文件夹。

  5. 在 链接器>输入>附加依赖项 中，指定完整路径和 LIB 文件的文件名。

  6. 选择“确定”。

有关 C++ 项目设置的详细信息，请参阅 Windows C++ 属性页参考。

生成调试版本

请确保在开始调试之前生成该 DLL 的调试版本。 若要调试 DLL，调用应用程序必须能够找到其 .pdb 文件 和 DLL 要求的任何其他文件。

可以创建自定义生成任务，以将 DLL 文件复制到 <调用项目文件夹>\Debug 输出文件夹，也可以手动将文件复制到其中。

请确保调用位于正确位置的 DLL。 这似乎是理所当然的，但如果调用应用找到并加载其他不同的 DLL，调试器将永远不会命中你设置的断点。

调试 DLL

无法直接运行 DLL。 它必须由应用（通常是 .exe 文件）调用。 有关详细信息，请参阅 Visual Studio 项目 - C++。

若要调试 DLL，你可以从调用应用开始调试，或通过指定其调用应用从 DLL 项目开始调试。 此外可以使用调试器即时窗口在设计时计算 DLL 函数或方法，而无需使用调用应用。

有关详细信息，请参阅初探调试器。

从调用应用启动调试

调用 DLL 的应用可以是：

  • Visual Studio 项目中与 DLL 在同一或不同解决方案中的应用。
  • 已经在测试或生产计算机上部署且正在运行的现有应用。
  • 位于 Web 上并通过 URL 访问。
  • 具有嵌入了 DLL 的网页的 Web 应用。

从调用应用程序调试 DLL，你可以：

  • 打开调用应用的项目，然后通过选择“调试”>“启动调试”或按 F5 来启动调试 。

    or

  • 附加到已经在测试或生产计算机上部署且正在运行的应用。 将此方法用于网站或 Web 应用中的 DLL。 有关详细信息，请参阅如何：附加到正在运行的进程。

在开始调试调用应用之前，请在 DLL 中设置断点。 请参阅使用断点。 DLL 断点命中时，可以单步跟踪代码，观察每个行的操作。 有关详细信息，请参阅在调试器中浏览代码。

在调试过程中，可以使用“模块”窗口验证应用加载的 DLL 和 .exe 文件。 若要在调试期间打开“模块”窗口，请选择“调试”>“窗口”>“模块”。 有关详细信息，请参阅如何：使用“模块”窗口。

使用“即时”窗口

你可以使用即时窗口，以在设计时计算 DLL 函数或方法。 即时窗口充当调用应用的角色。

注意

在设计时，可以对大多数项目类型使用“即时”窗口。 SQL、Web 项目或脚本不支持该窗口。

例如，若要在 Class1 类中测试名为 Test 的方法:

  1. 打开 DLL 项目， 通过选择调试>窗口>即时或按Ctrl+Alt+I 打开 即时 窗口。

  2. 在 即时窗口中键入以下 C# 代码并按Enter，以实例化Class1类型的对象。 此托管代码也适用于 C# 和 Visual Basic，只需进行合适的语法更改：

    Class1 obj = new Class1();

    在 C# 中，所有名称必须是全限定名称。 语言服务尝试计算表达式的值时，所有使用的方法或变量必须在当前作用域和上下文中。

  3. 假设 Test 带有一个 int 参数，使用 即时 窗口计算 Test ：

    ?obj.Test(10);

    结果输出到 即时 窗口中。

  4. 可以继续调试 Test，方法为在其中设置断点，然后再次计算函数。

    命中断点后，可以单步跟踪Test。 Test 执行后，调试器将回到设计模式。

混合模式调试

可以在托管代码或本机代码中为 DLL 编写调用应用。 如果本机应用调用托管 DLL，并且你想要调试两者，则可以在项目属性中同时启用托管和本机调试器。 确切流程取决于是要从 DLL 项目还是从调用应用项目开始调试。 有关详细信息，请参阅如何：在混合模式下调试。

也可以从托管调用项目中调试本机 DLL。 有关详细信息，请参阅如何调试托管和本机代码。

相关内容