Net綜合項(xiàng)目代碼編寫(xiě)標(biāo)準(zhǔn)規(guī)范

目錄1.C#代碼風(fēng)格規(guī)定 31.1注釋 31.2類型（類、構(gòu)造、委托、接口）、字段、屬性、辦法、事件命名 31.3不使用縮寫(xiě) 41.4代碼使用半展開(kāi) 41.5使用Tab作為縮進(jìn)，并設(shè)立縮進(jìn)大小為4 51.6一種.cs源文獻(xiàn)至多定義兩個(gè)類型 71.7類型名稱和源文獻(xiàn)名稱必要一致 71.8所有命名空間、類型名稱使用Pascal風(fēng)格（單詞首字母大寫(xiě)） 71.9本地變量、辦法參數(shù)名稱使用Camel風(fēng)格（首字母小寫(xiě)，其后每個(gè)單詞首字母大寫(xiě)） 71.10私有辦法、受保護(hù)辦法，仍使用Pascal風(fēng)格命名 81.11如果if語(yǔ)句內(nèi)容只有一行，可以不加花括號(hào)，但是必要和if語(yǔ)句位于同一行 81.12調(diào)用類型內(nèi)部其她成員，需加this；調(diào)用父類成員，需加base 91.13類型內(nèi)部私有和受保護(hù)字段，使用Camel風(fēng)格命名，但加“_”前綴 91.14不能浮現(xiàn)公有字段 101.15類型成員排列順序 101.16委托和事件命名 111.17返回bool類型辦法、屬性命名 111.18常用集合類型后綴命名 121.19常用后綴命名 121.20常用類型命名 131.21常用字段、屬性命名 142.XHTML代碼風(fēng)格規(guī)定 142.1如果XHTML標(biāo)記有層次，那么代碼也要有層次 142.2所有標(biāo)記必要閉合 152.3如果標(biāo)記中間代碼超過(guò)20行，則應(yīng)在標(biāo)記末尾加注標(biāo)記 153.CSS代碼風(fēng)格規(guī)定 163.1代碼使用半展開(kāi) 163.2使用Tab作為縮進(jìn)，并設(shè)立縮進(jìn)大小為4 163.3代碼注釋 163.4代碼編寫(xiě) 163.5嵌入式樣式比例不超過(guò)樣式表代碼總量10% 173.6內(nèi)聯(lián)式樣式比例不超過(guò)樣式表代碼總量30% 173.7外聯(lián)式樣式表比例不少于樣式表代碼總量60% 174.JavaScript代碼風(fēng)格規(guī)定 184.1代碼使用半展開(kāi) 184.2使用Tab作為縮進(jìn)，并設(shè)立縮進(jìn)大小為4 184.3代碼注釋 184.4不得浮現(xiàn)內(nèi)嵌式代碼 184.5內(nèi)聯(lián)式代碼占JavaScript總量不得超過(guò)40% 184.6外聯(lián)式代碼占JavaScript總量至少為60% 19

1.C#代碼風(fēng)格規(guī)定1.1注釋類型、屬性、事件、辦法、辦法參數(shù)，依照需要添加注釋。如果類型、屬性、事件、辦法、辦法參數(shù)名稱已經(jīng)是自解釋了，不需要加注釋；否則需要添加注釋。當(dāng)添加注釋時(shí)，添加方式如下圖所示：1.2類型（類、構(gòu)造、委托、接口）、字段、屬性、辦法、事件命名優(yōu)先考慮英文，如果英文沒(méi)有適當(dāng)單詞描述，可以使用拼音，使用中文是不符合規(guī)定。唯一可以使用中文地方是枚舉枚舉項(xiàng)，枚舉項(xiàng)實(shí)際已經(jīng)不屬于本節(jié)標(biāo)題范疇了。這里只是放到一起闡明，如下圖所示：1.3不使用縮寫(xiě)所有類型、辦法、參數(shù)、變量命名不得使用縮寫(xiě)，涉及人們熟知縮寫(xiě)，例如msg。1.4代碼使用半展開(kāi)第一步，打開(kāi)VisualStudio，進(jìn)入“工具”，“選項(xiàng)...”，如下圖所示：第二步，進(jìn)入“文本編輯器”，“C#”，“格式設(shè)立”，“新行”，取消掉右側(cè)所有復(fù)選框中對(duì)號(hào)，如下圖所示：第三步，點(diǎn)擊“擬定”，完畢設(shè)立。1.5使用Tab作為縮進(jìn)，并設(shè)立縮進(jìn)大小為4第一步，打開(kāi)VisualStudio，進(jìn)入“工具”，“選項(xiàng)...”，如下圖所示：第二步，進(jìn)入“文本編輯器”，“C#”，“制表符”，如下圖所示，設(shè)立制表符。第三步，點(diǎn)擊“擬定”，完畢設(shè)立。1.6一種.cs源文獻(xiàn)至多定義兩個(gè)類型如果兩個(gè)類型關(guān)系是緊密有關(guān)，例如產(chǎn)品、產(chǎn)品類型，此時(shí)Product類，和ProductType枚舉可以定義在同一種Product.cs文獻(xiàn)中。但不能在一種.cs文獻(xiàn)中浮現(xiàn)兩個(gè)不有關(guān)類型定義，例如將Product類和Reseller類（分銷商）定義在一種BasicInfo.cs文獻(xiàn)中。1.7類型名稱和源文獻(xiàn)名稱必要一致當(dāng)類型命名為Product時(shí)，其源文獻(xiàn)命名只能是Product.cs。1.8所有命名空間、類型名稱使用Pascal風(fēng)格（單詞首字母大寫(xiě)）如下圖所示，紅色標(biāo)記為使用Pascal風(fēng)格類型：注意ProductType是私有類型，不論類型是公有還是私有，其命名總是采用Pascal風(fēng)格。1.9本地變量、辦法參數(shù)名稱使用Camel風(fēng)格（首字母小寫(xiě)，其后每個(gè)單詞首字母大寫(xiě)）紅色標(biāo)記為使用Camel風(fēng)格變量或者辦法參數(shù)：1.10私有辦法、受保護(hù)辦法，仍使用Pascal風(fēng)格命名示例代碼如下：1.11如果if語(yǔ)句內(nèi)容只有一行，可以不加花括號(hào)，但是必要和if語(yǔ)句位于同一行范例1.9中if判斷事實(shí)上與下面語(yǔ)句是等效：1.12調(diào)用類型內(nèi)部其她成員，需加this；調(diào)用父類成員，需加base示例代碼如下：1.13類型內(nèi)部私有和受保護(hù)字段，使用Camel風(fēng)格命名，但加“_”前綴代碼示例如下：1.14不能浮現(xiàn)公有字段如果需要公有字段，使用屬性進(jìn)行包裝。1.15類型成員排列順序類型成員排列順序自上而下依次為：字段：私有字段、受保護(hù)字段屬性：私有屬性、受保護(hù)屬性、公有屬性事件：私有事件、受保護(hù)事件、公有事件構(gòu)造函數(shù)：參數(shù)數(shù)量最多構(gòu)造函數(shù)，參數(shù)數(shù)量中檔構(gòu)造函數(shù)，參數(shù)數(shù)量至少構(gòu)造函數(shù)辦法：重載辦法排列順序與構(gòu)造函數(shù)相似，從參數(shù)數(shù)量最多往下至參數(shù)至少。1.16委托和事件命名委托以EventHandler作為后綴命名，例如SalesOutEventHandler。事件以其相應(yīng)委托類型，去掉EventHandler后綴，并加上On前綴構(gòu)成。例如，對(duì)于SalesOutEventHandler委托類型事件，其事件名稱為：OnSalesOut。示例代碼如下：1.17返回bool類型辦法、屬性命名如果辦法返回類型為bool類型，則其前綴為Is、Can或者Try，例如：1.18常用集合類型后綴命名凡符合下表所列集合類型，應(yīng)添加相應(yīng)后綴。闡明后綴示例數(shù)組Arrayint[]productArray列表ListList<Product>productListDataTable/HashTableTableHashTableproductTable字典DictionaryDictionay<string,string>productDictionaryEF中DbSet/DataSetSetDbSet<Product>productSet1.19常用后綴命名凡符合下表所列局部變量、辦法參數(shù)、字段、屬性，均需添加相應(yīng)后綴。闡明后綴示例示例闡明費(fèi)用有關(guān)CostShipCost運(yùn)送費(fèi)價(jià)格有關(guān)PriceProductUnitPrice產(chǎn)品單價(jià)消息有關(guān)Message（棄用Note）SuccessMessage成功消息日期有關(guān)Date（棄用Time）OrderDate下單日期計(jì)數(shù)、數(shù)量有關(guān)Count（棄用Time）LoginCount登錄次數(shù)鏈接地址有關(guān)UrlBlogUrl博客鏈接圖片有關(guān)ImageSignImage簽名圖片金額有關(guān)AmountPrepaidAmount預(yù)付款點(diǎn)數(shù)、積分有關(guān)PointMemberPoint會(huì)員積分記錄、日記有關(guān)Record（棄用Log）ErrorRecord錯(cuò)誤記錄配備有關(guān)ConfigDataBaseConfig數(shù)據(jù)庫(kù)配備狀態(tài)有關(guān)StatusOrderStatus訂單狀態(tài)模式、方式有關(guān)ModeOpenMode打開(kāi)方式種類有關(guān)Category/Type二選一UserCategory顧客種類工廠類有關(guān)FactoryConnectionFactory連接工廠啟用有關(guān)EnabledExportEnabled啟動(dòng)導(dǎo)出流有關(guān)StreamUploadStream上傳流讀取器有關(guān)ReaderExcelReaderExcel讀取器寫(xiě)入器有關(guān)WriterExcelWriterExcel寫(xiě)入器適配器有關(guān)AdapterIntroOPAdapterIntroOP適配器提供器有關(guān)ProviderMemebershipProvider會(huì)員信息提供器包裝器有關(guān)WrapperProductWrapperProduct包裝器連接有關(guān)ConnectionExcelConnectionExcel連接1.20常用類型命名凡存在下表中類型，需采用下表指定名稱命名。類型命名類型命名客戶Customer分銷商Reseller零售商Retailer經(jīng)銷商/批發(fā)商Dealer顧客UserInfo（User為數(shù)據(jù)庫(kù)核心字）訂單OrderInfo（Order為數(shù)據(jù)庫(kù)核心字）供應(yīng)商Supplier管理員Admin密碼Password會(huì)員Member評(píng)論Remark（棄用Comment）文章Article新聞News發(fā)票Invoice導(dǎo)入Import導(dǎo)出Export公司、公司Company（棄用Enterprise）產(chǎn)品Product省份Province都市City區(qū)縣District地址Address角色Role（棄用Group）權(quán)限Authority（棄用Permission）倉(cāng)庫(kù)Warehouse工廠Plant登錄Login（棄用SignIn）登出LogOut（棄用SignOut）創(chuàng)立Create（棄用Add）編輯Edit更新Update刪除Remove（棄用Delete）照片Photo圖片Image1.21常用字段、屬性命名字段、屬性種類比較繁雜，因而僅列出最慣用幾項(xiàng)。類型名稱類型名稱Id（int型）Id（“d”小寫(xiě)，棄用ID）GuidId（Guid型）IdName名稱Title標(biāo)題Remark備注、描述（棄用Memo、Description）Category種類（棄用Class、Type）Linkman聯(lián)系人

2.XHTML代碼風(fēng)格規(guī)定2.1如果XHTML標(biāo)記有層次，那么代碼也要有層次下面是書(shū)寫(xiě)符合規(guī)定例子：下面是書(shū)寫(xiě)

不符合規(guī)定

例子：2.2所有標(biāo)記必要閉合示例代碼如下：2.3如果標(biāo)記中間代碼超過(guò)20行，則應(yīng)在標(biāo)記末尾加注標(biāo)記標(biāo)注方式如下：3.CSS代碼風(fēng)格規(guī)定3.1代碼使用半展開(kāi)設(shè)立辦法參照1.4節(jié)。3.2使用Tab作為縮進(jìn)，并設(shè)立縮進(jìn)大小為4設(shè)立辦法參照1.5節(jié)。3.3代碼注釋注釋重要闡明該樣式應(yīng)用于頁(yè)面哪個(gè)某些，而非闡明樣式應(yīng)用效果，代碼注釋風(fēng)格如下所示：3.4代碼編寫(xiě)每一種樣式設(shè)立必要獨(dú)占一行，不能位于同一行，下面是符合規(guī)定寫(xiě)法：下面是

不符合規(guī)定

寫(xiě)法：3.5嵌入式樣式比例不超過(guò)樣式表代碼總量10%嵌入式樣式為直接寫(xiě)在HTML標(biāo)記內(nèi)部樣式，如下圖所示：3.6內(nèi)聯(lián)式樣式比例不超過(guò)樣式表代碼總量30%內(nèi)聯(lián)式樣式為寫(xiě)在<head></head>中樣式，如下圖所示：內(nèi)聯(lián)式樣式，不能

寫(xiě)在<body></body>之間。3.7外聯(lián)式樣式表比例不少于樣式表代碼總量60%外聯(lián)式樣式表為寫(xiě)在.css文獻(xiàn)中樣式，通過(guò)link引入到XHTML頁(yè)面中，如下圖所示：4.JavaScript代碼風(fēng)格規(guī)定4.1代碼使用半展開(kāi)設(shè)立辦法參照1.4節(jié)。4.2使用Tab作為縮進(jìn)，并設(shè)立縮進(jìn)大小為4設(shè)立辦法參照1.5節(jié)。4.3代碼注釋代碼注釋需要闡