如何在 Visual Studio 2010 中为 C++ 方法 ala C# 和 VB 启用/实现 XML 注释?默认情况下,此功能似乎未启用/可用。
以最初托管的 C++ 项目为目标。
如何在 Visual Studio 2010 中为 C++ 方法 ala C# 和 VB 启用/实现 XML 注释?默认情况下,此功能似乎未启用/可用。
以最初托管的 C++ 项目为目标。
配置属性 -> C/C++ -> 输出文件 -> 生成 XML 文档文件。
您必须手动添加所有 xml 文档(/// 不会为您自动创建摘要模板)。也不支持 paramref。http://msdn.microsoft.com/en-us/library/ms173501.aspx
要在输入 /// 时自动完成 xml 文档存根,请尝试CppTripleSlash - c++扩展的 xml 文档注释。它还有一些基本的智能感知来完成文档注释中的 xml 标签。
我知道这是旧的,但我看到每个人都说不支持,需要 3rd 方工具或类似工具,没有一个不是真的。您需要知道的是,在 Visual Studio 2010 中支持并提供 XML 文档,关于它只有两件事需要了解:
文档/以前的版本/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 文档文件中。并且文档在以后的其他项目中也可以正常工作。
这在 VS2010 的 C++ 中不受支持。