本文實例講述了C#實現為類和函數代碼自動添加版權注釋信息的方法,分享給大家供大家參考之用。具體方法如下:
以web項目為例:
一:給類加注釋
1.在visual studio 的安裝路徑下
如:[盤符]:/Program files/Microsoft Visual Studio 8/Common7/IDE/ItemTemplates/web/cshare/2052/class.zip ,將裡面的class.cs改為:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74/*----------------------------------------------------------------
// 版權所有。
//
// 文件名:
// 文件功能描述:
//
//
// 創建標識:
//
// 修改標識:
// 修改描述:
//
// 修改標識:
// 修改描述:
//----------------------------------------------------------------*/
using
System;
using
System.Data;
using
System.Configuration;
using
System.Web;
using
System.Web.Security;
using
System.Web.UI;
using
System.Web.UI.WebControls;
using
System.Web.UI.WebControls.WebParts;
using
System.Web.UI.HtmlControls;
/// <summary>
/// $safeitemrootname$ 的摘要說明
/// </summary>
public
class
$safeitemrootname$
{
public
$safeitemrootname$()
{
//
// TODO: 在此處添加構造函數邏輯
//
}
}
/*----------------------------------------------------------------
// 版權所有。
//
// 文件名:
// 文件功能描述:
//
//
// 創建標識:
//
// 修改標識:
// 修改描述:
//
// 修改標識:
// 修改描述:
//----------------------------------------------------------------*/
using
System;
using
System.Data;
using
System.Configuration;
using
System.Web;
using
System.Web.Security;
using
System.Web.UI;
using
System.Web.UI.WebControls;
using
System.Web.UI.WebControls.WebParts;
using
System.Web.UI.HtmlControls;
/// <summary>
/// $safeitemrootname$ 的摘要說明
/// </summary>
public
class
$safeitemrootname$
{
public
$safeitemrootname$()
{
//
// TODO: 在此處添加構造函數邏輯
//
}
}
保存文件即可(先解壓,在修改)
二:VS宏腳本添加函數注釋模板
現在的IDE越做越強大,為我等懶人省了不少。為了使用將來的代碼自己或別人能看懂,注釋這種東西必不可少。當為函數添加注釋時,格式是固定的。每個函數寫一遍,或從別的函數處拷貝過來,即麻煩又容易出錯。這種重復勞動讓人心煩都有不想寫注釋的欲望了,這時VS的宏可以干掉這些“髒、亂、累”的體力活。
看了一下,vs2010的宏腳本就是VBScript,很容易上手。我寫了一個生成函數注釋模板的宏腳本,比較容易,看代碼:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60Imports System
Imports EnvDTE
Imports EnvDTE80
Imports EnvDTE90
Imports System.Diagnostics
Public Module Module1
Sub AddFunComment()
Dim DocSel As EnvDTE.TextSelection
DocSel = DTE.ActiveDocument.Selection
DocSel.NewLine()
DocSel.Text =
"/*******************************************************************"
DocSel.NewLine()
DocSel.Text =
"* 函數名稱: "
DocSel.NewLine()
DocSel.Text =
"* 功 能: "
DocSel.NewLine()
DocSel.Text =
"* 參 數: "
DocSel.NewLine()
DocSel.Text =
"* 返 回 值: "
DocSel.NewLine()
DocSel.Text =
"* 作 者: Lonkil"
DocSel.NewLine()
DocSel.Text =
"* 電子郵箱: lonkil{AT}gmail.com ( {AT} -> @ )"
DocSel.NewLine()
DocSel.Text =
"* 創建日期: "
+ System.DateTime.Now.ToLongDateString()
DocSel.NewLine()
DocSel.Text =
"*******************************************************************/"
End Sub
End Module
Imports System
Imports EnvDTE
Imports EnvDTE80
Imports EnvDTE90
Imports System.Diagnostics
Public Module Module1
Sub AddFunComment()
Dim DocSel As EnvDTE.TextSelection
DocSel = DTE.ActiveDocument.Selection
DocSel.NewLine()
DocSel.Text =
"/*******************************************************************"
DocSel.NewLine()
DocSel.Text =
"* 函數名稱: "
DocSel.NewLine()
DocSel.Text =
"* 功 能: "
DocSel.NewLine()
DocSel.Text =
"* 參 數: "
DocSel.NewLine()
DocSel.Text =
"* 返 回 值: "
DocSel.NewLine()
DocSel.Text =
"* 作 者: Lonkil"
DocSel.NewLine()
DocSel.Text =
"* 電子郵箱: lonkil{AT}gmail.com ( {AT} -> @ )"
DocSel.NewLine()
DocSel.Text =
"* 創建日期: "
+ System.DateTime.Now.ToLongDateString()
DocSel.NewLine()
DocSel.Text =
"*******************************************************************/"
End Sub
End Module
具體的創建步驟:vs2010 IDE -> 工具 -> 宏 -> 新建宏項目,選擇要保存的位置。然後將要上面的腳本復制進去,保存即可。
具體的使用:為你編寫的宏綁定快捷鍵,vs2010 IDE -> 工具 -> 選項 -> 在左邊列表中選擇“鍵盤” -> 在右邊的“顯示命令包含”中,選擇你創建宏-> 將光標定位到”按快捷鍵”處 -> 輸入你想命名的快捷鍵,比如”Alt+C”,保存即可。
有一點需要注意:Visual Studio 2005 Team Suite 需要打上SP1補丁,宏方能使用否則無效。
相信本文所述對大家的C#程序設計有一定的借鑒價值。