演练:在 Visual Studio 中编译面向 CLR 的 C++/CLI 程序

通过使用 C++/CLI,可以创建使用 .NET 类以及本机 C++ 类型的 C++ 程序。 C++/CLI 用于控制台应用程序和 DLL,这些 DLL 包装原生 C++ 代码并使其可从 .NET 程序访问。 若要创建基于 .NET 的 Windows 用户界面,请使用 C# 或 Visual Basic。

在此过程中,可以键入自己的 C++ 程序或采用示例程序之一。 我们在此过程中使用的示例程序创建了名为“textfile.txt”的文本文件,并将其保存到项目目录。

先决条件

  • 你需要了解 C++ 语言的基础知识。
  • 在 Visual Studio 2017 及更高版本中,C++/CLI 支持是一个可选组件。 若要安装它,请从 Windows 开始菜单打开“Visual Studio 安装程序”。 确保选中“使用 C++ 的桌面开发”磁贴,并在“可选”组件部分选中“C++/CLI 支持”

创建新项目

根据使用的 Visual Studio 版本,以下步骤会有所不同。 若要查看 Visual Studio 首选项的文档,请使用“版本”选择器控件。 它位于此页面上目录表的顶部。

在 Visual Studio 中创建 C++/CLI 项目

  1. 在“解决方案资源管理器”中,右键单击顶部以打开“创建新项目”对话框

  2. 在对话框顶部的搜索框中输入“CLR”,然后从结果列表中选择“CLR 空项目(.NET Framework)”。

  3. 选择“创建”按钮创建项目。

在 Visual Studio 2017 中创建 C++/CLI 项目

  1. 创建新项目。 在 “文件” 菜单上,指向 “新建” ,然后单击 “项目”

  2. 在 Visual C++ 项目类型中,依次单击“CLR”、“CLR 空项目”

  3. 键入项目名称。 默认情况下,包含该项目的解决方案具备和新项目一样的名称,不过可以输入一个不同的名称。 可以按需要为项目输入不同的位置。

  4. 单击“确定”以创建新项目

在 Visual Studio 2015 中创建 C++/CLI 项目

  1. 创建新项目。 在 “文件” 菜单上,指向 “新建” ,然后单击 “项目”

  2. 在 Visual C++ 项目类型中,依次单击“CLR”、“CLR 空项目”

  3. 键入项目名称。 默认情况下,包含该项目的解决方案具备和新项目一样的名称,不过可以输入一个不同的名称。 可以按需要为项目输入不同的位置。

  4. 单击“确定”以创建新项目

添加源文件

  1. 如果“解决方案资源管理器”不可见,请单击“视图”菜单上的“解决方案资源管理器”

  2. 向项目添加新的源文件:

    • 在“解决方案资源管理器”中右键单击“源文件”文件夹,指向“添加”并单击“新建项”

    • 单击“C++ 文件 (.cpp)”并键入文件名,然后单击“添加”

    .cpp 文件会出现在“解决方案资源管理器”中的“源文件”文件夹中,并且当你按需要在该文件中键入代码时,会出现一个选项卡式窗口。

  3. 单击 Visual Studio 中新创建的选项卡并键入有效的 Visual C++ 程序或从示例程序中复制粘贴一个。

    例如,可以使用如何:编写文本文件 (C++/CLI) 示例程序(位于编程指南中的“文件处理和 I/O”节点)

    如果使用该示例程序,请注意在创建 .NET 对象时使用 gcnew 关键字(而不是 new 关键字),并且 gcnew 返回图柄 (^) 而不是指针 (*):

    StreamWriter^ sw = gcnew StreamWriter(fileName);

    有关 C++/CLI 语法的更多信息,请参阅运行时平台的组件扩展

  4. “生成” 菜单上,单击 “生成解决方案”

    “输出”窗口显示编译进度的相关信息,例如生成日志的位置以及指示生成状态的消息

    如果在未进行生成操作的情况下做出更改且运行程序,则可能出现一个指示该程序已过期的对话框。 如果希望 Visual Studio 始终使用当前版本的文件而不是在每次生成应用程序时都出现提示,请选择该对话框中的复选框后再单击“确定”

  5. 在“调试”菜单上,单击“开始执行(不调试)”

  6. 如果使用了示例程序,在运行程序时会显示一个命令窗口,该窗口指示已创建文本文件。

    textfile.txt 文本文件现在位于你的项目目录中。 可以使用记事本打开此文件。

    注意

    选择自动设置 /clr 编译器选项的空 CLR 项目模板。 为了验证这一点,请在“解决方案资源管理器”中右键单击该项目并单击“属性”,然后选中“配置属性”的“常规”节点中的“公共语言运行时支持”选项

另请参阅

C++ 语言参考
项目和生成系统