標籤:style blog http ar 使用 strong sp 檔案 資料
★前言
最近下載了tita_chou在CSDN上傳的一個資源,是在工作中整理的C#協助類,裡麵包含了很多實用的類,想到我之前收集過自己用到少的可憐的類,心生敬意啊。當粗略的查看了那個資源,發現有一些是重複的,有一些我的裡面有的那個沒有,於是乎就萌生了重新整理一個屬於自己的協助類,於是乎就花了幾個晚上的時間,重新過了一遍,還借用SandCastle工具產生了協助文檔(CHM),這一個開源的工具,感覺產生協助文檔挺方便的,下面會介紹這個工具。
★為什麼要整理
為什麼要整理這個協助類呢,其實我也不太清楚,可能跟我有收藏的愛好有關吧,說起我的收藏,曆史淵源啊……其實我感覺這樣做的一個好處是,就是減少重複造輪子或者找輪子的重複勞動。以前在寫代碼中經常遇到一個似曾相識的功能,好像在哪做過,但又想不起來,於是就開始翻以前寫的代碼,翻來翻去,好不容易找到了感覺是上帝的恩賜似的,趕緊複製粘貼過來,也有不少時候找不到在哪,於是一狠心一跺腳重寫一遍吧!浪費了很多時間,說不定還被追債,很是不爽,所以就有了這個通用庫,以後可以多花點時間在自己的核心業務上了,這樣說來還是有必要的,我相信很多朋友都有類似整理的習慣吧。
★整理過程
整個過程也沒有用到多少技術,整個過程還是輕鬆愉快的,並接觸到了新的東西,已經很滿足了,在這裡簡單的記錄一下整理的過程:
1、合并功能重複的類;
2、完善類的注釋;
3、精簡冗餘代碼;
4、利用SandCastle工具產生協助文檔,不熟悉SandCastle可以參考這裡,關於.NET中的XML注釋規則參考這裡,張子秋前輩已經寫的很詳細了,受益匪淺;
5、源碼上傳到Github,在這裡,同時上傳的還有使用SandCastle建立的產生協助文檔的項目,使用的方法主要參考這裡;
6、利用Windows Live Writer寫這篇部落格,第一次用,感覺還不錯,主要是可以離線寫博文,不會因為網路問題引起資料丟失(想起來之前用網頁編輯器,一不小心就沒了,都是淚啊),參考在這裡。
★整理成果
下面就是這幾天整理的成果,CHM檔案目錄的,看起來成果頗豐啊,不過裡面的東西還是慘不忍睹啊(還有很大部分不太完善):
★總結
雖然花了幾個晚上看電影的時間,不過感覺這工作挺值了,以後或多或少會用的到吧,尤其是學會使用SandCastle產生協助文檔和Live Writer寫部落格了(大神勿笑)。不過在整理的過程中也看到了自己還是很無知啊,很多東西都沒弄明白,總以為進入這行也有兩年左右也有不少經驗了,但現在的水平也就剛入門吧,以後還有很長一段路要走啊。
★聲明及願景
此項目中的代碼是基於tita_chou上傳的資源的加工及進一步整理,尊重原作者的著作權,若涉及侵權,請聯絡我刪除源碼。不過我還是希望大家能夠共同完善這個項目,現在還有很多不完善的地方,包括注釋不全,大部分代碼都沒經過測試,也存在很多功能重複的地方,期待您的加入,讓我們一起把這個程式碼程式庫做的更強大,源碼在這裡!!!
★參考
下面列出文章中沒有提到的參考
SandCastle參考:
http://blog.csdn.net/yl2isoft/article/details/18454115
http://www.cnblogs.com/net515/p/3311584.html
http://www.cnblogs.com/zhangziqiu/archive/2009/01/31/1381666.html
http://www.veryhuo.com/a/view/71066.html
Windows Live Writer參考:
http://www.cnblogs.com/lyj/archive/2008/11/30/1344463.html
http://www.cnblogs.com/cmt/archive/2012/06/25/2560793.html
http://www.cnblogs.com/cmt/archive/2012/06/26/live_writer_cnblogs_entryname.html
http://www.cnblogs.com/cmt/archive/2012/06/26/live_writer_cnblogs_code_highlight.html
C#通用類Helper整理