1

我很喜欢 Visual Studio 中的“///”功能,但我发现它以 XML 显示的事实令人迷惑。我更希望输出看起来像 javadocs:

/**
 * @author      Firstname Lastname <address @ example.com>
 * @version     1.6                 (current version number of program)
 * @since       2010-03-31          (version of the package this class was first added to)
 */

有没有办法做到这一点?我不在乎数据可能无法在应用程序之外访问(例如自动生成的 API 文档)。我只是想要这个,以便我和另一个查看代码的人可以看到每个函数的一些简洁统一的注释。

4

2 回答 2

0

好吧,从技术上讲,有一种方法可以做到这一点,但是您需要自己编写 Visual Studio 的扩展,以便在 VS 中直观地格式化 XML 注释,同时在源文件中保持原始格式。

类似于这篇 XML 评论文章末尾的基于 WPF 的查看器(我相信这只是一个内部原型)。

我在 Visual Studio 库中没有看到执行此操作的扩展。也许概念上最接近的是ItalicComments,但这不是您所追求的。

于 2013-01-15T23:23:48.233 回答
0

使用键盘快捷键创建一个片段以包含您自己的评论样式。

片段编辑器是执行此操作的便捷工具。

但是,如果其他用户习惯于在 Visual Studio 和 C# 中工作,那么他们会因为查看除 XML 结构之外的任何其他注释方式而迷失方向。

于 2013-01-15T19:46:31.537 回答