Visual Basic.NET編程標(biāo)準(zhǔn)

前言
第I部分 設(shè)計(jì)
第1章 創(chuàng)建對(duì)象和項(xiàng)目模板
1.1 使用對(duì)象模板
1.2 使用項(xiàng)目模板
1.3 編程原則
1.3.1 絕不要在對(duì)象模板中對(duì)應(yīng)用程序和組件特有的值進(jìn)行硬編碼
1.3.2 在對(duì)象模板中特別是需修改之處提供廣泛的注釋和任務(wù)
第2章 設(shè)計(jì)模塊和過(guò)程
2.1 創(chuàng)建具有很強(qiáng)內(nèi)聚性的模塊
2.2 創(chuàng)建松耦合和高度特定化過(guò)程
2.2.1 使所有過(guò)程都執(zhí)行特定的功能
2.2.2 盡量提高過(guò)程的獨(dú)立性
2.2.3 最小化扇入和扇出
2.2.4 盡量按字母表順序排列模塊中的過(guò)程
2.3 編程原則
2.3.1 給過(guò)程和模塊起一個(gè)表意性強(qiáng)的名稱(chēng)
2.3.2 給每個(gè)過(guò)程設(shè)定惟一的出口
2.3.3 給每個(gè)過(guò)程定義一個(gè)明確的范圍
2.3.4 在過(guò)程之間用參數(shù)傳遞數(shù)據(jù)
2.3.5 使用統(tǒng)一和直觀明了的方式調(diào)用過(guò)程
2.3.6 使用Return語(yǔ)句返回函數(shù)值
2.3.7 在復(fù)雜函數(shù)中使用暫存變量
第II部分 約定
第3章 命名約定
3.1 匈牙利表示法
3.2 什么情況下不用匈牙利表示法
3.3 指明變量的數(shù)據(jù)類(lèi)型
3.4 指明變量的范圍
3.5 其他對(duì)象別綴
第4章 使用常量和枚舉
4.1 使用常量
4.1.1 幻數(shù)容易出現(xiàn)數(shù)據(jù)輸入錯(cuò)誤
4.1.2 幻數(shù)難以更新
4.1.3 常量使代碼更容易閱讀
4.2 使用枚舉
4.2.1 創(chuàng)建自定義枚舉
4.2.2 使用自定義枚舉
4.3 編程原則
4.3.1 給所有常量加上前輟C和范圍指示符
4.3.2 用常量代替幻數(shù)而不必考慮可見(jiàn)范圍
4.3.3 盡可能使用枚舉
4.3.4 參數(shù)接收數(shù)量有限的值時(shí)使用枚舉
4.3.5 驗(yàn)證作為枚舉類(lèi)型傳遞的值
第5章 變量
5.1 編程原則
5.1.1 定義用途明確的變量
5.1.2 給變量起一個(gè)表意性強(qiáng)的名稱(chēng)
5.1.3 在變量名中混合使用大小寫(xiě)字母
5.1.4 只對(duì)常用變量名或長(zhǎng)變量名使用縮寫(xiě)
5.1.5 使用統(tǒng)一限定詞
5.1.6 使用肯定形式的Boolean變量
5.1.7 顯式聲明變量
5.1.8 用精選的數(shù)據(jù)類(lèi)型聲明變量
5.1.9 只有在絕對(duì)必要時(shí)才使用Object數(shù)據(jù)類(lèi)型
5.1.10 使用Option Strict選項(xiàng)嚴(yán)格限制類(lèi)型
5.1.11 最小化變量可見(jiàn)范圍
5.1.12 盡可能使用初始值設(shè)定項(xiàng)
5.1.13 使用與號(hào)（＆）連接字符串
5.1.14 用字符串長(zhǎng)度屬性判斷字符串是否為空
第III部分 編碼結(jié)構(gòu)
第6章 格式化代碼
6.1 編程原則
6.1.1 不要在同一行中放入多個(gè)語(yǔ)句
6.1.2 使用續(xù)行符
6.1.3 縮進(jìn)連續(xù)行
6.1.4 使用縮進(jìn)顯示代碼的組織結(jié)構(gòu)
6.1.5 在模塊聲明部分縮進(jìn)代碼以顯示從屬關(guān)系
6.1.6 用空行把相關(guān)的語(yǔ)句分組
6.1.7 創(chuàng)建可折疊的代碼區(qū)域以便管理
第7章 注釋代碼
7.1 編程原則
7.1.1 用文字說(shuō)明代碼的作用
7.1.2 解釋為什么要違背良好的編程風(fēng)格
7.1.3 在寫(xiě)代碼前先寫(xiě)注釋
7.1.4 單色字符注釋行僅用于主要注釋
7.1.5 不要?jiǎng)?chuàng)建注釋框
7.1.6 用撇號(hào)表示注釋
7.1.7 增強(qiáng)注釋的可讀性
7.1.8 縮進(jìn)注釋使之與隨后的語(yǔ)句對(duì)齊
7.1.9 給每個(gè)過(guò)程寫(xiě)一個(gè)注釋頭
7.1.10 用內(nèi)嵌注釋說(shuō)明代碼進(jìn)程
7.1.11 用行尾變量來(lái)說(shuō)明變量聲明
第8章 循環(huán)結(jié)構(gòu)
8.1 編程原則
8.1.1 循環(huán)次數(shù)確定時(shí)使用For…Next循環(huán)
8.1.2 循環(huán)次數(shù)不確定時(shí)使用Do…Loop循環(huán)
8.1.3 用Do…Loop循環(huán)代替While…End While
8.1.4 使用For Each…Next循環(huán)遍歷集合中的成員
第9章 控制代碼流
9.1 編程原則
9.1.1 判斷基于一個(gè)條件的值是否為真時(shí)使用If…Then…Else分支結(jié)構(gòu)
9.1.2 當(dāng)把一個(gè)非Boolean表達(dá)式與多個(gè)值進(jìn)行比較時(shí)使用Select Case語(yǔ)句
9.1.3 使用行尾注釋增加嵌套判斷結(jié)構(gòu)的清晰度
9.1.4 格式化表達(dá)式以便準(zhǔn)確求值和易于理解
9.1.5 僅在別無(wú)選擇時(shí)才使用GoTo語(yǔ)句
第10章 異常處理
10.1 異常對(duì)象
10.2 異常處理程序的類(lèi)型
10.3 使用Try…Catch…Finally語(yǔ)句編寫(xiě)異常處理程序
10.3.1 捕獲異常
10.3.2 異常處理程序和調(diào)用堆棧
10.4 中央異常處理程序
10.4.1 把異常寫(xiě)入文本文件
10.5 編程原則
10.5.1 用Try…Catch…Finally處理不可預(yù)料的和可預(yù)料的異常
10.5.2 處理不可預(yù)料的異常時(shí)使用統(tǒng)一的格式
10.5.3 永遠(yuǎn)不要指責(zé)用戶(hù)
第IV部分 高級(jí)編程
第11章 編程對(duì)象
11.1 什么是對(duì)象
11.2 垃圾回收
11.3 編程原則
11.3.1 要盡早綁定對(duì)象
11.3.2 要盡可能使用.NET對(duì)象而不是調(diào)用API函數(shù)
11.3.3 公開(kāi)公共屬性而不是公開(kāi)公共交量
11.3.4 無(wú)論打開(kāi)什么資源都要關(guān)閉它們
11.3.5 使用OverLoads創(chuàng)建名稱(chēng)相同但參數(shù)列表不同的屬性和方法
11.3.6 為所有對(duì)象創(chuàng)建Dispose方法
11.3.7 要盡可能為類(lèi)創(chuàng)建構(gòu)造函數(shù)
11.3.8 僅在必要時(shí)才在類(lèi)中添加終結(jié)器
11.3.9 僅在必要時(shí)才強(qiáng)制執(zhí)行垃圾回收
11.3.10 使用With…End With提高性能和代碼的可讀性
第12章 文件操作
12.1 System.IO
12.1.1 System.IO.File和System.IO.Directory
12.1.2 System.IO.Path
12.2 System.Environment
12.3 編程原則
12.3.1 把所有臨時(shí)文件都保存在用戶(hù)的Temp文件夾中
12.3.2 用系統(tǒng)指定的臨時(shí)文件名保存臨時(shí)文件
12.3.3 及時(shí)關(guān)閉不再需要訪問(wèn)的文件
12.3.4 決不要在程序中使用硬編碼路徑
12.3.5 使用System.IO.Path來(lái)操縱文件路徑
12.3.6 文件的默認(rèn)保存路徑為用戶(hù)的MyDocuments文件夾
12.3.7 將文件添加到用戶(hù)最近用過(guò)的文檔列表中
12.3.8 刪除重要文件時(shí)請(qǐng)求確認(rèn)
第13章 調(diào)試
13.1 從Visual Basic 6到Visual Basic.NET
13.1.1 用數(shù)據(jù)提示查看表達(dá)式的值
13.1.2 用Debug.Assert定義斷言
13.2 條件編譯
13.2.1 編寫(xiě)條件編譯代碼
13.2.2 用項(xiàng)目【屬性頁(yè)】對(duì)話框設(shè)置編譯器常量
13.2.3 用命令行設(shè)置編譯器常量
13.3 斷點(diǎn)
13.3.1 設(shè)置和刪除斷點(diǎn)
13.3.2 進(jìn)入中斷模式
13.3.3 使用【斷點(diǎn)】窗口管理斷點(diǎn)
13.3.4 用Stop語(yǔ)句進(jìn)入中斷模式
13.4 Visual Basic.NET調(diào)試窗口
13.4.1 【自動(dòng)】窗口
13.4.2 【局部變量】窗口
13.4.3 Me窗口
13.4.4 【監(jiān)視】窗口
13.4.5 【快速監(jiān)視】窗口
13.4.6 【命令】窗口
13.4.7 【輸出】窗口
13.4.8 【任務(wù)列表】窗口
13.4.9 【模塊】窗口
13.4.10 【內(nèi)存】窗口
13.4.11 【調(diào)用堆棧】窗口
13.5 編程原則
13.5.1 啟動(dòng)項(xiàng)目時(shí)不進(jìn)行調(diào)試而不是刪除或禁用調(diào)試代碼
13.5.2 當(dāng)調(diào)用Debug.Assert時(shí)不要?jiǎng)?chuàng)建修改數(shù)據(jù)的表達(dá)式
13.5.3 斷言目的不明確時(shí)要指定自定義斷言文本
13.5.4 盡可能使用Option Strict選項(xiàng)
13.5.5 給全部過(guò)程都加上異常處理代碼
13.5.6 在條件編譯的調(diào)試代碼中使用固有的DEBUG常量
13.5.7 用斷點(diǎn)來(lái)確保復(fù)雜的過(guò)程得到完全執(zhí)行
13.5.8 盡可能使用斷點(diǎn)而不要使用Stop語(yǔ)句
13.5.9 創(chuàng)建注釋作為T(mén)ODO任務(wù)
第V部分 用戶(hù)交互
第14章 界面設(shè)計(jì)
14.1 設(shè)計(jì)一致界面的要性
14.2 編程原則
14.2.1 使所有窗體具有一致的外觀和行為
14.2.2 用標(biāo)準(zhǔn)的外觀顯示控件
14.2.3 根據(jù)具體情況使用最好的界面組件
14.2.4 提供可理解并且有意義的菜單
14.2.5 盡可能使用系統(tǒng)顏色
第15章 用戶(hù)輸入與通知
15.1 用戶(hù)輸入
15.2 通知
15.3 編程原則
15.3.1 確保完整的鍵盤(pán)導(dǎo)航與交互
15.3.2 提供直觀一致的鼠標(biāo)交互
15.3.3 創(chuàng)建有意義且實(shí)用的消息框
15.3.4 如果應(yīng)用程序允許用戶(hù)打開(kāi)并保存很多文件則應(yīng)用程序應(yīng)記住用戶(hù)所選的路徑
第16章 發(fā)布解決方案
16.1 準(zhǔn)備要發(fā)布的項(xiàng)目
16.2 創(chuàng)建自定義安裝程序
16.2.1 添加項(xiàng)目的輸出
16.2.2 定義項(xiàng)目輸出的生成選項(xiàng)
16.2.3 向安裝程序中添加文件
16.2.4 文件屬性
16.2.5 改變【應(yīng)用程序文件夾】的默認(rèn)位置
16.2.6 使用目標(biāo)計(jì)算機(jī)上的文件夾
16.2.7 改變文件的安裝文件夾
16.2.8 創(chuàng)建快捷方式
16.2.9 在安裝過(guò)程中修改注冊(cè)表
16.2.10 修改自定義安裝程序的用戶(hù)界面
16.2.11 指定配置細(xì)節(jié)
16.2.12 指定卸載信息
16.2.13 建立自定義安裝程序
16.3 編程原則
16.3.1 對(duì)界面進(jìn)行拼寫(xiě)檢查
16.3.2 調(diào)整窗體上控件的對(duì)齊方式
16.3.3 測(cè)試所有窗體的Tab鍵順序
16.3.4 檢查重復(fù)的訪問(wèn)鍵
16.3.5 檢查所有對(duì)話框的接受和取消按鈕
16.3.6 檢查消息對(duì)話框的格式
16.3.7 確保每一個(gè)過(guò)程都有異常處理程序
16.3.8 核實(shí)所使用第3方組件的版本是否正確
16.3.9 為所有已發(fā)布的程序指定邏輯的根命名空間
16.3.10 對(duì)程序進(jìn)行徹底的測(cè)試與調(diào)試
16.3.11 檢查條件編譯量
16.3.12 不要將文件安裝到用戶(hù)的桌面上
16.3.13 不要將快捷方式直接放在Program Files文件夾中
16.3.14 除非能夠確定所有目標(biāo)計(jì)算機(jī)安裝了恰當(dāng)?shù)腤indows Installer否則應(yīng)該包含引導(dǎo)程序
16.3.15 將安裝項(xiàng)目命名為“程序名Installer”
16.3.16 為項(xiàng)目設(shè)置合適的版本號(hào)
16.3.17 為每個(gè)已安裝的組件創(chuàng)建一個(gè)有意義的圖標(biāo)
16.3.18 務(wù)必將路徑［ProgramFilesFloder］［Manufacturer］＼［ProductName］作為默認(rèn)的【應(yīng)用序文件夾】
16.3.19 除非有特殊原因，否則應(yīng)在【應(yīng)用程序文件夾】中創(chuàng)建所有自定義文件夾
16.3.20 只在需要時(shí)包含調(diào)試信息
16.3.21 將所有COM文件的SharedLegacy屬性設(shè)置為T(mén)rue
16.3.22 將關(guān)鍵文件的Vital屬性設(shè)置為T(mén)rue
16.3.23 為安裝程序項(xiàng)目設(shè)置合適的生成順序
16.3.24 除非有特殊原因，否則應(yīng)將創(chuàng)建的所有自定義注冊(cè)表鍵值設(shè)置為DeleteAtUninstall
第VI部分 團(tuán)隊(duì)項(xiàng)目
第17章 版本管理
17.1 了解程序集
17.2 編程原則
17.2.1 每次編譯程序時(shí)遞增版本號(hào)
17.2.2 在【關(guān)于】對(duì)話框中顯示程序的版本號(hào)
17.2.3 將組件安裝在與客戶(hù)端使用該組件相同的文件夾中
17.2.4 推出組件的新版本時(shí)要保持兼容性
17.2.5 修改Readme文件中的內(nèi)容
17.2.6 備份自己的文件
17.2.7 使用Visual SourceSafe維護(hù)源代碼的版本
第18章 源代碼管理
18.1 確定團(tuán)隊(duì)開(kāi)發(fā)所面臨的挑戰(zhàn)
18.2 了解Visual SourceSafe
18.3 設(shè)置Visual SourceSafe
18.3.1 創(chuàng)建Visual SourceSafe數(shù)據(jù)庫(kù)
18.3.2 打開(kāi)Visual SourceSafe Database
18.3.3 向Visual SourceSafe數(shù)據(jù)庫(kù)中添加用戶(hù)
18.3.4 將Visual Basic項(xiàng)目置于Visual SourceSafe的管理之下
18.4 Visual Basic項(xiàng)目與Visual SourceSafe
18.4.1 指定工作文件夾
18.4.2 創(chuàng)建項(xiàng)目的工作副本
18.4.3 通過(guò)Visual SourceSafe Explorer簽出文件
18.4.4 從Visual Basic IDE中簽入和簽出文件
18.4.5 向源代碼處于管制中的項(xiàng)目添加新文件
18.4.6 獲得文件的最新版本
18.4.7 比較修訂