程式狂想曲

在寫程式的時候，寫註解是一件很煩人的事，但註解不寫，是以後更痛苦的事
在現在的.net的環境下 有很多方式協助寫註解
最基本的就是XML註解（看到XML不要怕，我也不太懂，這是為了方便輸出時候用的）

&lt summary> ddddddd&lt/summary>
當呼叫有用XML註解的Function Class Structure ..........會顯示在Summary裡 ddddddd 的資訊

&lt param name="sTitle">123 &lt /param name>
當要輸入參數 sTitle時 出現的註解123

&lt returns>567&lt returns>
傳回值的註解


C# 按 /// 自動出現以下

/// &lt summary&gt
///
/// &lt /summary&gt
/// &lt param name="sTitle"&gt
/// &lt param name="sName"&gt
/// &lt returns&gt &lt /returns&gt&ltreturns&gt&lt/returns&gt&ltreturns&gt&lt/returns&gt

VB.NET 按 ''' 自動出現以下

''' &lt summary>
'''
''' &lt /summary>
''' &lt remarks>&lt /remarks>

範例
''' &lt summary>
''' 傳入檔案路徑 傳回檔案所在磁碟
''' &lt /summary>
''' &lt param name="filepath">路徑
''' &lt returns>磁碟機代號&lt /returns>
''' &lt remarks>&lt /remarks>
Public Function GetFileDisk(ByVal filepath As String)

Dim v As String()
v = Split(filepath, "\")
Return v(0)
End Function

更詳細的說明（中英）
http://www.wewill.cn/n113c7.aspx

更多的XML tag （英）
http://www.winnershtriangle.com/w/articles.xmlcommentsinvbnet.asp