【正文】 oductIDDataAdapterdaddadProductsDataReaderdtrdtrProductsDataSetdstdstNorthWindDataTabledtbldtblProductDataRowdrowdrowRow98DataColumndcoldcolProductIDDataRelationdreldrelMasterDetailDataViewdvwdvwFilteredProducts8頁面規(guī)范對(duì)于多處使用的頁面樣式要定義。DataGrid、GridView等列表顯示中字段值為字符且長(zhǎng)度超過6個(gè)漢字的，使字段值左對(duì)齊；字段值為數(shù)字的，使字段值右對(duì)齊；除整數(shù)外其他含有小數(shù)的，一般情況下四舍五入保留2為小數(shù)，特殊數(shù)字根據(jù)實(shí)際業(yè)務(wù)具體處理。如：折扣輸入正整數(shù)，印張保留3為小數(shù)，材料單位為噸的保留6位小數(shù)，為令的保留3位小數(shù)，為張的保留1位小數(shù)。 DataGrid、GridView等列表顯示中默認(rèn)每頁顯示15行。 DataGrid、GridView等列表中的字段標(biāo)題居中對(duì)齊，不換行。 列表頁面中輸入控件、選擇控件、下拉控件盡量保持寬度一致，擺放位置為左對(duì)齊，字段標(biāo)題居中對(duì)齊不換行，字段標(biāo)題不能兩邊對(duì)齊的，默認(rèn)右對(duì)齊；頁面中有字段驗(yàn)證控件的，如果列表中有如：“增加”、“統(tǒng)計(jì)”等定位到新頁面按鈕的，請(qǐng)把此按鈕的頁面驗(yàn)證去掉，如果驗(yàn)證控件驗(yàn)證數(shù)據(jù)對(duì)按鈕執(zhí)行結(jié)果有影響的如：“打印”，需要加驗(yàn)證。例如：?jiǎn)T工姓名為下拉框，在HTML頁面中加STYLE。 列表頁面中的頁面標(biāo)題居中顯示，要和菜單和具體表述的模塊或功能保持一致。 新開發(fā)列表模塊中使用的控件、樣式必須使用系統(tǒng)中存在的最新的，如：翻頁控件； 提交、顯示、列表等頁面中的日期輸入框默認(rèn)寬度為70px只讀+日期選擇控件；下來選擇框默認(rèn)90px；輸入框默認(rèn)90px；盡量遵循控件左對(duì)齊和兩邊對(duì)齊的方式。 提交、顯示頁面中的顯示字段，如果字段值不超過6個(gè)漢字的，默認(rèn)居中對(duì)齊，超過6個(gè)漢字的默認(rèn)左對(duì)齊；如：叢書信息有可能超過6個(gè)漢字，左對(duì)齊。 頁面數(shù)據(jù)驗(yàn)證控件的位置和被驗(yàn)證控件的保持同行且不換行，驗(yàn)證控件如：requiredfieldvalidator的ErrorMessage要和ToolTip保持一致，其它存在此屬性的驗(yàn)證控件也按照此方式執(zhí)行；驗(yàn)證控件提示信息中的標(biāo)點(diǎn)符號(hào)用中文全角。1 日期格式?jīng)]有特殊要求的情況下一律默認(rèn)：yyyyMMdd 格式。1 頁面中的冗余代碼全部刪除。1 頁面中控件的擺放位置需要通過Table表格去約束此控件所處位置，不能把多個(gè)控件放在同一個(gè)TD中且通過br或amp。nbsp。去實(shí)現(xiàn)位置的擺放。1 HtmlControl控件的寬度盡量使用style=”width:90px”去約束而不是用size=6。 同種類型的腳本盡量放到同一個(gè)位置。 腳本中的提示信息的格式要和頁面驗(yàn)證控件的提示信息保持一致；如：提示中的標(biāo)點(diǎn)符號(hào)要使用中文全角。 腳本變量、數(shù)組、對(duì)象、驗(yàn)證、返回值等命名規(guī)則同樣遵循帕斯卡和駱駝命名法； 頁面中的字段命名盡量和表設(shè)計(jì)中的字段名稱保持一致。 對(duì)于字段名稱和數(shù)據(jù)表中當(dāng)成設(shè)計(jì)字段名稱不一致且需要呈現(xiàn)的，如果有特殊呈現(xiàn)器的，可以借助字段呈現(xiàn)器呈現(xiàn)，如：xx信息SeriesInfo可以命名為：SeriesInfo_SESNAME，便于以后程序維護(hù)。9其他 類型轉(zhuǎn)換盡量避免強(qiáng)制類型轉(zhuǎn)換。如果不得不做類型轉(zhuǎn)換，盡量用顯式方式。 錯(cuò)誤與提示權(quán)限驗(yàn)證錯(cuò)誤頁面，要有返回按鈕。錯(cuò)誤頁面的信息提示要簡(jiǎn)明、扼要，表述客戶可以理解的，開發(fā)人員明確錯(cuò)誤原因的。1. 命名陷阱從名字看是引導(dǎo)走向A,而實(shí)際上引導(dǎo)的方向卻是A的相反方向,挖著坑讓人跳.比如：bool isPoised = ( amp。amp。 != )?？疵謎sPoised表示“已沖紅”的意思，而繼續(xù)仔細(xì)看代碼，卻驚奇的發(fā)現(xiàn)它表達(dá)的是“不是沖紅”的意思，如此命名一不小心就引導(dǎo)人犯錯(cuò)誤。2. 偷懶設(shè)計(jì)加一個(gè)字段就可以解決的問題，卻要用另一種危險(xiǎn)的設(shè)計(jì)。比如：BookStorage圖書庫存期初的存儲(chǔ)，完全可以在圖書庫存表加一個(gè)字段存儲(chǔ)期初值，而目前卻在圖書庫存里單獨(dú)加一條數(shù)據(jù)記錄來存儲(chǔ)期初（用修裝數(shù)量等于1來區(qū)別）。這樣維護(hù)困難，還很容易出錯(cuò)，萬一修裝數(shù)量出現(xiàn)1了怎么辦？3. 捉迷藏存儲(chǔ)蘋果放在存放蘋果的地方容易找到，把蘋果放到存放西紅柿的地方呢？放在大家都熟悉的地方需要的時(shí)候才容易找到。比如：方法BookProductionStorageIn表示的是“生產(chǎn)樣書單入庫”的操作怎么放到印制單操作類里去了，這讓同事怎么找？4. 重復(fù)制造輪子相同功能的相同方法何必重復(fù)寫，框架提供了經(jīng)過測(cè)試的方法不用。增加維護(hù)工作量，還容易產(chǎn)生BUG，輪子已經(jīng)制造完成就不要再制造重復(fù)的。5. 越描越黑有問題就要找到問題的根源，徹底解決，而不是繞開問題，大家都繞誰來解決。比如：“類別”還有顯示值是空的設(shè)置項(xiàng)？這是開發(fā)人員寫的代碼把“請(qǐng)選擇”存儲(chǔ)到數(shù)據(jù)庫里了，導(dǎo)致顯示的頁面會(huì)顯示“未知數(shù)：0”，正確的應(yīng)該是把錯(cuò)誤存儲(chǔ)進(jìn)數(shù)據(jù)庫的代碼修正過來，而不應(yīng)該在數(shù)據(jù)里增加這么一項(xiàng)來繞過去，蒙蔽大家的眼睛。6. 硬代碼這個(gè)問題說過很多此，基本上每次開會(huì)都強(qiáng)調(diào)不允許寫硬代碼，硬代碼產(chǎn)生的錯(cuò)誤有時(shí)候非常難發(fā)現(xiàn),大量奇怪的問題都是來源于硬代碼導(dǎo)致。比如：Session命名不定義直接引用等大量的這類問題。其他未列問題；10簡(jiǎn)版要求 編碼要求 禁止使用縮寫命名,國際通用的除外。如：不允許把ProjectId命名成pid等。 用詞要正規(guī)，簡(jiǎn)潔，恰當(dāng)，不能用漢語拼音,編碼風(fēng)格一致，表達(dá)意思易懂。 所以源代碼文件(二進(jìn)制文件，版本日志除外)必須以UTF8帶簽名格式保存，防止出現(xiàn)亂碼情況 不允許寫硬代碼，都在常量類中定義再引用不允許：if(=1) { …….. }推薦： if(=) { …….. }涉及Sql語句編寫的地方如果有參數(shù)要傳遞，必須把Sql語句參數(shù)化，防止Sql注入。不允許：select * from Book where BookName=’張三’推薦： select * from Book where BookName=@Bookname,其中@Bookname的值為’張三’編寫Sql語句時(shí)表的別名定義大家都熟悉的名字，讀取的列必須限定表前綴,原始列名大小寫必須和數(shù)據(jù)庫一樣。錯(cuò)誤：Select projectid from Project pj ,Book bk where =正確： Select from Project pj ,Book bk where =代碼注釋要簡(jiǎn)潔準(zhǔn)確，格式符合要求。對(duì)外公開的方法(類等)：/// summary /// 創(chuàng)建待辦全局?jǐn)?shù)據(jù),創(chuàng)建前會(huì)自動(dòng)檢測(cè)全局?jǐn)?shù)據(jù)中是否已存在的相同主鍵的紀(jì)錄 /// 如果存在將先刪除，否則直接插入 /// /summary /// param name=entityId單據(jù)Id/param /// param name=entityTypeName單據(jù)Model名/param /// param name=trigerColumnName觸發(fā)列名/param internal static void CreateGlobalData(int entityId, string entityTypeName, string trigerColumnName) { ……. }對(duì)外公開的變量：///summary///“真”的常量字符串////summaryinternal int TRUESTRING=”True”局部變量：int beginIndex=0。//索引開始位置/*索引開始位置*/int beginIndex=0。代碼高效，兼容性強(qiáng).。使用前先判斷是否滿足使用條件。功能性代碼(界面外的，如某個(gè)流程)必須都放在對(duì)應(yīng)的Info文件(BLL)中，不允許在頁面(UI)，方便自動(dòng)化測(cè)試和代碼共享。頁面(UI)。1同一個(gè)功能的代碼不允許在多個(gè)地方定義。1因日期區(qū)域性問題，根據(jù)日期生成文件名稱時(shí)在64位操作系統(tǒng)上會(huì)出現(xiàn)問題，如下代碼為有問題的：string nfn=().Replace(,).Replace(:,).Replace( ,)+ext。 建議使用時(shí)間的滴答數(shù)來生成；1VS2012中代碼格式統(tǒng)一設(shè)置。如下圖：在菜單欄中點(diǎn)擊工具選項(xiàng)，找到文本編輯器HTML格式，點(diǎn)擊標(biāo)記專用選項(xiàng)。在標(biāo)記專用選項(xiàng)的客戶端HTML標(biāo)記中選擇要設(shè)置的標(biāo)記然后按如下描述設(shè)置標(biāo)記的格式標(biāo)記名換行符div之前和之后td之前和之后VS2012中設(shè)置JavaScript的格式 編碼技巧腳本編寫中，為避免重復(fù)恢復(fù)數(shù)據(jù)庫和方便腳本調(diào)試，可以嘗試以下方法：BEGINTRANDELETEFROM Project WHERE ProjectId = 1COMMITROLLBACKGO在寫SQL糾錯(cuò)腳本的時(shí)候注意觀察數(shù)據(jù)的變化條數(shù)，確保變化的數(shù)據(jù)都是需要修正的； 在使用VS2012中盡量使用開發(fā)工具自帶的功能如：.CS中【組織using】菜單中的“移除和排序”等功能；ASPX盡量使用【HTML源編輯】菜單中的自動(dòng)格式化頁面代碼功能；對(duì)函數(shù)參數(shù)順序調(diào)整盡量用【重構(gòu)】菜單中的“重新排列參數(shù)功能”以便對(duì)相關(guān)引用統(tǒng)一修改；附錄一：命名由來匈牙利命名法匈牙利命名法是一名匈牙利程序員發(fā)明的，而且他在微軟工作了多年。此命名法就是通過微軟的各種產(chǎn)品和文檔傳出來的。多數(shù)有經(jīng)驗(yàn)的程序員，不管他們用的是哪門兒語言，都或多或少在使用它。這種命名法的基本原則是：變量名＝屬性＋類型＋對(duì)象描述即一個(gè)變量名是由三部分信息組成，這樣，程序員很容易理解變量的類型、用途，而且便于記憶。下邊是一些推薦使用的規(guī)則例子，你可以挑選使用，也可以根據(jù)個(gè)人喜好作些修改再用之。⑴屬性部分：全局變量： g_常量： c_類成員變量： m_⑵類型部分：指針： p句柄： h布爾型： b浮點(diǎn)型： f 無符號(hào)： u⑶描述部分：初始化： Init臨時(shí)變量： Tmp目的對(duì)象： Dst源對(duì)象： Src窗口： Wnd 下邊舉例說明：hwnd： h表示句柄，wnd表示窗口，合起來為“窗口句柄”。m_bFlag： m表示成員變量，b表示布爾，合起來為：“某個(gè)類的成員變量，布爾型，是一個(gè)狀態(tài)標(biāo)志”。駱駝（Camel）命名法駱駝式命令法，正如它的名稱所表示的那樣，是指混合使用大小寫字母來構(gòu)成變量和函數(shù)的名字。例如，下面是分別用駱駝式命名法和下劃線法命名的同一個(gè)函數(shù)： printUserPaychecks()；print_user_paychecks()； 第一個(gè)函數(shù)名使用了駱駝式命名法——函數(shù)名中的每一個(gè)邏輯斷點(diǎn)都有一個(gè)大寫字母來標(biāo)記；第二個(gè)函數(shù)名使用了下劃線法函數(shù)名中的每一個(gè)邏輯斷點(diǎn)都有一個(gè)下劃線來標(biāo)記。駱駝式命名法近年來越來越流行了，在許多新的函數(shù)庫和MicrosoftWindows這樣的環(huán)境中，它使用得當(dāng)相多。另一方面，下劃線法是c出現(xiàn)后開始流行起來的，在許多舊的程序和UNIX這樣的環(huán)境中，它的使用非常普遍。帕斯卡（pascal）命名法與駱駝命名法類似。只不過駱駝命名法是首字母小寫，而帕斯卡命名法是首字母大寫 如：public voidDisplayInfo()。string UserName。二者都是采用了帕斯卡命名法。在C中，以帕斯卡命名法和駱駝命名法居多。簡(jiǎn)單說MyData 就是一個(gè)帕斯卡命名的示例 而myData是一個(gè)駱駝命名法,它第一個(gè)單詞的第一個(gè)字母小寫,后面的單詞首字母大寫,看起來像一個(gè)駱駝 而iMyData是一個(gè)匈牙利命名法,它的小寫的i說明了它的型態(tài),后面的和帕斯卡命名相同,指示了該變量的用途.附錄二：資料來源此編碼規(guī)范編寫一是參照網(wǎng)絡(luò)搜集的資料，二是根據(jù)開發(fā)部開發(fā)過程中總結(jié)的代碼經(jīng)驗(yàn)整理而成，如果網(wǎng)絡(luò)來源的資料參考涉及到商業(yè)或不當(dāng)之處，請(qǐng)及時(shí)告知，我們會(huì)做相應(yīng)處理。附錄三：工具輔助【微軟內(nèi)部使用的編碼規(guī)則檢查工具】作為產(chǎn)品開發(fā)代碼檢查的一個(gè)輔助工具，如果不符合此規(guī)范的，要求開發(fā)人員限期修正；然后安裝；安裝完成后打開VS2012開發(fā)環(huán)境如下：：負(fù)責(zé)人在開始使用此軟件時(shí)會(huì)一次性把此文件加入解決方案文件夾【】，其他成員不用單獨(dú)指定。51