2013-07-31 99 views
2

我們正在升級大量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,我們正在俯瞰?

+0

_出現XML註釋之前_ - 出於好奇,他們何時被引入?我以爲他們總是在那裏。 –

+0

早在2000年代(.net 1.0/1,VS2002/3)。直到VS2005之前,VB.Net中沒有引入正式的XML註釋。 –

回答

0

(AFAIK)有沒有像它嵌入任何版本的VS.有可能可能是Resharper,Coderush或Justcode的東西。
FWIW:我會去寫一個帶有正則表達式魔法的簡單應用程序。