主頁 > 知識庫 > .Net 項目代碼風格要求小結

.Net 項目代碼風格要求小結

熱門標簽:代理接電話機器人如何取消 地圖定位圖標標注 400電話辦理哪家性價比高 濮陽外呼電銷系統(tǒng)怎么樣 塔城代理外呼系統(tǒng) 地圖標注專業(yè)團隊 地圖標注的公司有哪些 天心智能電銷機器人 遂寧市地圖標注app

PDF版下載:項目代碼風格要求V1.0.pdf

代碼風格沒有正確與否,重要的是整齊劃一,這是我擬的一份《.Net 項目代碼風格要求》,供大家參考。

1. C# 代碼風格要求1.1注釋

類型、屬性、事件、方法、方法參數(shù),根據(jù)需要添加注釋。

如果類型、屬性、事件、方法、方法參數(shù)的名稱已經(jīng)是自解釋了,不需要加注釋;否則需要添加注釋。

當添加注釋時,添加方式如下圖所示:

1.2 類型(類、結構、委托、接口)、字段、屬性、方法、事件的命名

優(yōu)先考慮英文,如果英文沒有合適的單詞描述,可以使用拼音,使用中文是不符合要求的。

唯一可以使用中文的地方是枚舉的枚舉項,枚舉項實際已經(jīng)不屬于本節(jié)標題的范疇了。這里只是放到一起說明,如下圖所示:

1.3 不使用縮寫

所有類型、方法、參數(shù)、變量的命名不得使用縮寫,包括大家熟知的縮寫,例如msg。

1.4 代碼使用半展開

第一步,打開Visual Studio,進入“工具”,“選項...”,如下圖所示:

第二步,進入“文本編輯器”,“C#”,“格式設置”,“新行”,取消掉右側所有復選框中的對號,如下圖所示:

第三步,點擊“確定”,完成設置。

1.5 使用Tab作為縮進,并設置縮進大小為4

第一步,打開Visual Studio,進入“工具”,“選項...”,如下圖所示:

第二步,進入“文本編輯器”,“C#”,“制表符”,如下圖所示,設置制表符。

第三步,點擊“確定”,完成設置。

1.6 一個.cs源文件至多定義兩個類型

如果兩個類型的關系是緊密相關的,比如 產(chǎn)品、產(chǎn)品類型,此時Product類,和ProductType枚舉可以定義在同一個Product.cs文件中。

但不能在一個.cs文件中出現(xiàn)兩個不相關的類型定義,例如將 Product類和Reseller類(分銷商)定義在一個BasicInfo.cs文件中。

1.7 類型名稱和源文件名稱必須一致

當類型命名為Product時,其源文件命名只能是Product.cs。

1.8 所有命名空間、類型名稱使用Pascal風格(單詞首字母大寫)

如下圖所示,紅色標記的為使用Pascal風格的類型:

注意ProductType是私有類型,不管類型是公有的還是私有的,其命名總是采用Pascal風格。

1.9 本地變量、方法參數(shù)名稱使用Camel風格(首字母小寫,其后每個單詞的首字母大寫)

紅色標記的為使用Camel風格的變量或者方法參數(shù):

1.10 私有方法、受保護方法,仍使用Pascal風格命名

示例代碼如下:

1.11 如果if語句內(nèi)容只有一行,可以不加花括號,但是必須和if語句位于同一行

范例1.9 中的if判斷實際上與下面的語句是等效的:

1.12 調(diào)用類型內(nèi)部其他成員,需加this;調(diào)用父類成員,需加base

示例代碼如下:

1.13 類型內(nèi)部的私有和受保護字段,使用Camel風格命名,但加“_”前綴

代碼示例如下:

1.14 不能出現(xiàn)公有字段

如果需要公有字段,使用屬性進行包裝。

1.15 類型成員的排列順序

類型成員的排列順序自上而下依次為:

字段:私有字段、受保護字段

屬性:私有屬性、受保護屬性、公有屬性

事件:私有事件、受保護事件、公有事件

構造函數(shù):參數(shù)數(shù)量最多的構造函數(shù),參數(shù)數(shù)量中等的構造函數(shù),參數(shù)數(shù)量最少的構造函數(shù)

方法:重載方法的排列順序與構造函數(shù)相同,從參數(shù)數(shù)量最多往下至參數(shù)最少。

1.16 委托和事件的命名

委托以EventHandler作為后綴命名,例如 SalesOutEventHandler。

事件以其對應的委托類型,去掉EventHandler后綴,并加上On前綴構成。

例如,對于SalesOutEventHandler委托類型的事件,其事件名稱為:OnSalesOut。

示例代碼如下:

1.17 返回bool類型的方法、屬性的命名

如果方法返回的類型為bool類型,則其前綴為Is、Can或者 Try,例如:

1.18 常見集合類型后綴命名

凡符合下表所列的集合類型,應添加相應的后綴。

說明 后綴 示例
數(shù)組 Array int[] productArray
列表 List ListProduct> productList
DataTable/HashTable Table HashTable productTable
字典 Dictionary Dictionaystring,string> productDictionary
EF中的DbSet /DataSet Set DbSetProduct> productSet

1.19 常見后綴命名

凡符合下表所列的局部變量、方法參數(shù)、字段、屬性,均需添加相應的后綴。

說明 后綴 示例 示例說明
費用相關 Cost ShipCost 運輸費
價格相關 Price ProductUnitPrice 產(chǎn)品單價
消息相關 Message(棄用Note) SuccessMessage 成功消息
日期相關 Date(棄用Time) OrderDate 下單日期
計數(shù)、數(shù)量相關 Count(棄用Time) LoginCount 登錄次數(shù)
鏈接地址相關 Url BlogUrl 博客鏈接
圖片相關 Image SignImage 簽名圖片
金額相關 Amount PrepaidAmount 預付款
點數(shù)、積分相關 Point MemberPoint 會員積分
記錄、日志相關 Record(棄用Log) ErrorRecord 錯誤記錄
配置相關 Config DataBaseConfig 數(shù)據(jù)庫配置
狀態(tài)相關 Status OrderStatus 訂單狀態(tài)
模式、方式相關 Mode OpenMode 打開方式
種類相關 Category / Type 二選一 UserCategory 用戶種類
工廠類相關 Factory ConnectionFactory 連接工廠
啟用相關 Enabled ExportEnabled 開啟導出
流相關 Stream UploadStream 上傳流
讀取器相關 Reader ExcelReader Excel讀取器
寫入器相關 Writer ExcelWriter Excel寫入器
適配器相關 Adapter IntroOPAdapter IntroOP適配器
提供器相關 Provider MemebershipProvider 會員信息提供器
包裝器相關 Wrapper ProductWrapper Product包裝器
連接相關 Connection ExcelConnection Excel連接

1.20 常見類型命名

凡存在下表中的類型,需采用下表指定的名稱命名。

類型 命名 類型 命名
客戶 Customer 分銷商 Reseller
零售商 Retailer 經(jīng)銷商/批發(fā)商 Dealer
用戶 UserInfo(User為數(shù)據(jù)庫關鍵字) 訂單 OrderInfo(Order為數(shù)據(jù)庫關鍵字)
供應商 Supplier 管理員 Admin
密碼 Password 會員 Member
評論 Remark(棄用Comment) 文章 Article
新聞 News 發(fā)票 Invoice
導入 Import 導出 Export
公司、企業(yè) Company(棄用Enterprise) 產(chǎn)品 Product
省份 Province 城市 City
區(qū)縣 District 地址 Address
角色 Role(棄用Group) 權限 Authority(棄用Permission)
倉庫 Warehouse 工廠 Plant
登錄 Login(棄用SignIn) 登出 LogOut(棄用SignOut)
創(chuàng)建 Create(棄用Add) 編輯 Edit
更新 Update 刪除 Remove(棄用Delete)
照片 Photo 圖片 Image

1.21 常見字段、屬性命名

字段、屬性種類比較繁雜,因此僅列出最常用的幾項。

類型 名稱 類型 名稱
Id(int型) Id(“d”小寫,棄用ID) GuidId(Guid型) Id
Name 名稱 Title 標題
Remark 備注、描述(棄用Memo、Description) Category 種類(棄用Class、Type)
Linkman 聯(lián)系人    

2. XHTML 代碼風格要求2.1 如果XHTML標記有層次,那么代碼也要有層次

下面是書寫符合要求的例子:

下面是書寫 不符合要求 的例子:

2.2 所有標記必須閉合

示例代碼如下:

2.3 如果標記中間代碼超過20行,則應在標記末尾加注標識

標注方式如下:

3. CSS 代碼風格要求3.1 代碼使用半展開

設置方法參考1.4節(jié)。

3.2 使用Tab作為縮進,并設置縮進大小為4

設置方法參考1.5節(jié)。

3.3 代碼注釋

注釋主要說明該樣式應用于頁面的哪個部分,而非說明樣式的應用效果,代碼注釋風格如下所示:

3.4 代碼編寫

每一個樣式設置必須獨占一行,不能位于同一行,下面是符合要求的寫法:

下面是 不符合要求 的寫法:

3.5 嵌入式樣式的比例不超過樣式表代碼總量的10%

嵌入式樣式為直接寫在HTML標記內(nèi)部的樣式,如下圖所示:

3.6 內(nèi)聯(lián)式樣式的比例不超過樣式表代碼總量的30%

內(nèi)聯(lián)式樣式為寫在head>/head>中的樣式,如下圖所示:

內(nèi)聯(lián)式樣式,不能 寫在body>/body>之間。

3.7 外聯(lián)式樣式表的比例不少于樣式表代碼總量的60%

外聯(lián)式樣式表為寫在.css文件中的樣式,通過link引入到XHTML頁面中,如下圖所示:

4. JavaScript 代碼風格要求4.1 代碼使用半展開

設置方法參考1.4節(jié)。

4.2 使用Tab作為縮進,并設置縮進大小為4

設置方法參考1.5節(jié)。

4.3 代碼注釋

代碼注釋需要說明“函數(shù)功能”、“入口參數(shù)”、“返回值”,注釋范例如下:

其中第一行說明函數(shù)功能;第二行說明入口參數(shù);最后一行說明返回值

4.4 不得出現(xiàn)內(nèi)嵌式代碼

內(nèi)嵌式代碼是指寫在XHTML標記中的JavaScript代碼,下面的寫法是 不符合要求 的:

4.5 內(nèi)聯(lián)式代碼占JavaScript的總量不得超過40%

內(nèi)聯(lián)式代碼是指寫在head />或者body />之間的代碼:

4.6 外聯(lián)式代碼占JavaScript的總量至少為60%

外聯(lián)式代碼指寫在單獨的.js文件中,然后通過script標記連接到XHTML頁面中的代碼。


感謝閱讀,希望這篇文章能給你帶來幫助!

您可能感興趣的文章:
  • 快速設置IDEA代碼風格為Google風格
  • eslint+prettier統(tǒng)一代碼風格的實現(xiàn)方法
  • 配置eslint規(guī)范項目代碼風格
  • 實例詳解Vue項目使用eslint + prettier規(guī)范代碼風格
  • 如何使用 Pylint 來規(guī)范 Python 代碼風格(來自IBM)
  • Pycharm學習教程(2) 代碼風格
  • php好代碼風格的階段性總結
  • 當前流行的JavaScript代碼風格指南
  • 你應該知道的Ruby代碼風格
  • 關于更改Zend Studio/Eclipse代碼風格主題的介紹
  • JQuery入門—JQuery程序的代碼風格詳細介紹
  • Java黑科技之通過Google Java Style 文件配置IDEA和Ecplise代碼風格

標簽:重慶 河南 麗江 汕頭 宜春 吉林 婁底 本溪

巨人網(wǎng)絡通訊聲明:本文標題《.Net 項目代碼風格要求小結》,本文關鍵詞  .Net,項目,代碼,風格,要求,;如發(fā)現(xiàn)本文內(nèi)容存在版權問題,煩請?zhí)峁┫嚓P信息告之我們,我們將及時溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡,涉及言論、版權與本站無關。
  • 相關文章
  • 下面列出與本文章《.Net 項目代碼風格要求小結》相關的同類信息!
  • 本頁收集關于.Net 項目代碼風格要求小結的相關信息資訊供網(wǎng)民參考!
  • 推薦文章