在 Visual Studio 2010 中启用 C++ 中的 XML 注释

Question

如何在 Visual Studio 2010 中为 C++ 方法（如 C# 和 VB）启用/实现 XML 注释？默认情况下，此功能似乎未启用/可用。

针对最初托管的 C++ 项目。

Answer 1

这是不是在C ++支持为VS2010。

Answer 2

配置属性 - > C / C ++ - >输出文件。 - >生成XML文档文件

您必须手动添加所有的XML文档（///不为你自动创建一个汇总模板）。同样不支持paramref。 http://msdn.microsoft.com/en-us/library/ms173501.aspx

Answer 3

要自动完成XML文档存根时///是类型化的尝试 CppTripleSlash - XML文档注释的C ++ 扩展。它也有一些基本的智能感知到文档注释中完整的XML标签。

Answer 4

我知道这是旧的，但我到处都看过，每个人都说不支持，需要第 3 方工具或类似工具，但没有一个不是真的。您需要知道的是，XML 文档在 Visual Studio 2010 中受支持并可用，关于它只需了解两件事：

1. 文档/以前的版本/Visual Studio/XML 文档/文档注释的推荐标签：https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2012/ms177227%28v%3dvs.90%29

2. 在“C++ 项目属性/C/C++/输出文件/生成 XML 文档文件”中设置为“是 (/doc)”

它将为每个包含文档注释“///”的源文件生成 .xdc 文件，并将其合并到一个 .xml 文档文件中。并且文档在以后的其他项目中也能正常工作。