在 Visual Studio 2010 中启用 C++ 中的 XML 注释
-
27-09-2019 - |
题
如何在 Visual Studio 2010 中为 C++ 方法(如 C# 和 VB)启用/实现 XML 注释?默认情况下,此功能似乎未启用/可用。
针对最初托管的 C++ 项目。
解决方案
这是不是在C ++支持为VS2010。
其他提示
配置属性 - > C / C ++ - >输出文件。 - >生成XML文档文件
您必须手动添加所有的XML文档(///不为你自动创建一个汇总模板)。同样不支持paramref。 http://msdn.microsoft.com/en-us/library/ms173501.aspx
要自动完成XML文档存根时///是类型化的尝试 CppTripleSlash - XML文档注释的C ++ 扩展。它也有一些基本的智能感知到文档注释中完整的XML标签。
我知道这是旧的,但我到处都看过,每个人都说不支持,需要第 3 方工具或类似工具,但没有一个不是真的。您需要知道的是,XML 文档在 Visual Studio 2010 中受支持并可用,关于它只需了解两件事:
文档/以前的版本/Visual Studio/XML 文档/文档注释的推荐标签:https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2012/ms177227%28v%3dvs.90%29
在“C++ 项目属性/C/C++/输出文件/生成 XML 文档文件”中设置为“是 (/doc)”
它将为每个包含文档注释“///”的源文件生成 .xdc 文件,并将其合并到一个 .xml 文档文件中。并且文档在以后的其他项目中也能正常工作。
不隶属于 StackOverflow