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,我們正在俯瞰?
_出現XML註釋之前_ - 出於好奇,他們何時被引入?我以爲他們總是在那裏。 –
早在2000年代(.net 1.0/1,VS2002/3)。直到VS2005之前,VB.Net中沒有引入正式的XML註釋。 –