C# 从常规注释生成XML注释

C# 从常规注释生成XML注释,c#,.net,vb.net,visual-studio-2012,xml-comments,C#,.net,Vb.net,Visual Studio 2012,Xml Comments,我们正在升级大量在XML注释出现之前创建的.Net代码 此代码包含大量注释,这些注释位于适用代码成员的正上方: ' This property returns true if ... Public ReadOnly Property ReturnTrueIf As Boolean 或者是我认为像sandcastle这样的自动文档编译器使用的“老式”格式: '=================================================== ' Class Descripti

我们正在升级大量在XML注释出现之前创建的.Net代码

此代码包含大量注释,这些注释位于适用代码成员的正上方:

' This property returns true if ...
Public ReadOnly Property ReturnTrueIf As Boolean
或者是我认为像sandcastle这样的自动文档编译器使用的“老式”格式:

'===================================================
' Class Description:
'   Description of this class
'
' Remarks:
'   Some remarks about this class.
'
Public Class SomeClass
这些注释中包含了大量有价值的信息,我们希望通过XML注释来公开这些信息

但是,我们只能手动转换这些注释,方法是首先插入xml注释模板(在成员正上方键入“”),然后在旧注释之前添加xml注释指示符(“”),然后手动将它们移动到新的xml块中。这显然是非常低效的

不幸的是,我们不能只使用嵌入在宏中的标准XML注释模板代码块,因为我们想要获取方法参数、返回值等

VS2012中是否有我们忽略的已知插件或功能?

(AFAIK)在任何版本的VS中都没有类似的插件或功能。在Resharper、Coderush或Justcode中可能有一些东西。
FWIW:我想写一个简单的应用程序,里面有Regex魔术。

在XML注释出现之前——出于好奇,它们是什么时候被引入的?我以为它们总是在那里。在21世纪初(.net 1.0/1,VS2002/3)。直到VS2005,VB.Net中才引入正式的XML注释。