从常规评论中生成XML评论

我们正在升级大量XML代码出现之前创建的.Net代码。从常规评论中生成XML评论

该代码包含了很多的是直接适用的标记元以上评论：

' This property returns true if ... 
Public ReadOnly Property ReturnTrueIf As Boolean

或“老派”的形式，我认为是使用自动文档编译器像沙塔：

'=================================================== 
' Class Description: 
' Description of this class 
' 
' Remarks: 
' Some remarks about this class. 
' 
Public Class SomeClass

在这些评论中有很多有价值的信息，我们希望通过XML评论来公开。

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

不幸的是，我们不能只使用嵌入在宏XML注释模板代码标准块，因为我们要皮卡方法参数，返回值等

是否有烤成任何已知的附加模块或功能VS2012，我们正在俯瞰？

来源

2013-07-31 competent_tech

_出现XML注释之前_ - 出于好奇，他们何时被引入？我以为他们总是在那里。 –

早在2000年代（.net 1.0/1，VS2002/3）。直到VS2005之前，VB.Net中没有引入正式的XML注释。 –

（AFAIK）有没有像它嵌入任何版本的VS.有可能可能是Resharper，Coderush或Justcode的东西。
FWIW：我会去写一个带有正则表达式魔法的简单应用程序。

来源

2013-07-31 20:13:28 LosManos

从常规评论中生成XML评论

回答

相关问题