亚洲香蕉成人av网站在线观看_欧美精品成人91久久久久久久_久久久久久久久久久亚洲_热久久视久久精品18亚洲精品_国产精自产拍久久久久久_亚洲色图国产精品_91精品国产网站_中文字幕欧美日韩精品_国产精品久久久久久亚洲调教_国产精品久久一区_性夜试看影院91社区_97在线观看视频国产_68精品久久久久久欧美_欧美精品在线观看_国产精品一区二区久久精品_欧美老女人bb

首頁 > 學院 > 開發設計 > 正文

.Net項目代碼風格規范

2019-11-14 15:51:07
字體:
來源:轉載
供稿:網友

最近沒啥時間自己狀態也不是很好,公司的事情忙,自己也有一些事情要處理,所以好久沒有寫博客了。利用公司午休時間寫一寫,以下是參考了一些資料,整理出來,共勉之。

代碼風格沒有正確與否,重要的是整齊劃一,清晰易讀。

1. C# 代碼風格要求

1.1注釋

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

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

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

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

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

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

1.3 不使用縮寫

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

1.4 代碼使用半展開

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

示例代碼如下:

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

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

1.12 調用類型內部其他成員,需加this;調用父類成員,需加base

示例代碼如下:

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

代碼示例如下:

1.14 不能出現公有字段

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

1.15 類型成員的排列順序

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

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

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

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

構造函數:參數數量最多的構造函數,參數數量中等的構造函數,參數數量最少的構造函數

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

1.16 委托和事件的命名

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

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

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

示例代碼如下:

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

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

1.18 常見集合類型后綴命名

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

說明后綴示例
數組Arrayint[] productArray
列表ListList<Product> productList
DataTable/HashTableTableHashTable productTable
字典DictionaryDictionay<string,string> productDictionary
EF中的DbSet /DataSetSetDbSet<Product> productSet

1.19 常見后綴命名

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

說明后綴示例示例說明
費用相關CostShipCost運輸費
價格相關PriceProductUnitPrice產品單價
消息相關Message(棄用Note)SuccessMessage成功消息
日期相關Date(棄用Time)OrderDate下單日期
計數、數量相關Count(棄用Time)LoginCount登錄次數
鏈接地址相關UrlBlogUrl博客鏈接
圖片相關ImageSignImage簽名圖片
金額相關AmountPrepaidAmount預付款
點數、積分相關PointMemberPoint會員積分
記錄、日志相關Record(棄用Log)ErrorRecord錯誤記錄
配置相關ConfigDataBaseConfig數據庫配置
狀態相關StatusOrderStatus訂單狀態
模式、方式相關ModeOpenMode打開方式
種類相關Category / Type 二選一UserCategory用戶種類
工廠類相關FactoryConnectionFactory連接工廠
啟用相關EnabledExportEnabled開啟導出
流相關StreamUploadStream上傳流
讀取器相關ReaderExcelReaderExcel讀取器
寫入器相關WriterExcelWriterExcel寫入器
適配器相關AdapterIntroOPAdapterIntroOP適配器
提供器相關ProviderMemebershipProvider會員信息提供器
包裝器相關WrapperProductWrapperProduct包裝器
連接相關ConnectionExcelConnectionExcel連接

1.20 常見類型命名

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

類型命名類型命名
客戶Customer分銷商Reseller
零售商Retailer經銷商/批發商Dealer
用戶UserInfo(User為數據庫關鍵字)訂單OrderInfo(Order為數據庫關鍵字)
供應商Supplier管理員Admin
密碼PassWord會員Member
評論Remark(棄用Comment)文章Article
新聞News發票Invoice
導入Import導出Export
公司、企業Company(棄用Enterprise)產品Product
省份Province城市City
區縣District地址Address
角色Role(棄用Group)權限Authority(棄用Permission)
倉庫Warehouse工廠Plant
登錄Login(棄用SignIn)登出LogOut(棄用SignOut)
創建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聯系人  

2. XHTML 代碼風格要求

2.1 如果XHTML標記有層次,那么代碼也要有層次

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

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

2.2 所有標記必須閉合

示例代碼如下:

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

標注方式如下:

3. CSS 代碼風格要求

3.1 代碼使用半展開

設置方法參考1.4節。

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

設置方法參考1.5節。

3.3 代碼注釋

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

3.4 代碼編寫

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

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

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

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

3.6 內聯式樣式的比例不超過樣式表代碼總量的30%

內聯式樣式為寫在<head></head>中的樣式,如下圖所示:

內聯式樣式,不能 寫在<body></body>之間。

3.7 外聯式樣式表的比例不少于樣式表代碼總量的60%

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

4. javaScript 代碼風格要求

4.1 代碼使用半展開

設置方法參考1.4節。

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

設置方法參考1.5節。

4.3 代碼注釋

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

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

4.4 不得出現內嵌式代碼

內嵌式代碼是指寫在XHTML標記中的Javascript代碼,下面的寫法是 不符合要求 的:

4.5 內聯式代碼占JavaScript的總量不得超過40%

內聯式代碼是指寫在<head />或者<body />之間的代碼:

4.6 外聯式代碼占JavaScript的總量至少為60%

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


發表評論 共有條評論
用戶名: 密碼:
驗證碼: 匿名發表
亚洲香蕉成人av网站在线观看_欧美精品成人91久久久久久久_久久久久久久久久久亚洲_热久久视久久精品18亚洲精品_国产精自产拍久久久久久_亚洲色图国产精品_91精品国产网站_中文字幕欧美日韩精品_国产精品久久久久久亚洲调教_国产精品久久一区_性夜试看影院91社区_97在线观看视频国产_68精品久久久久久欧美_欧美精品在线观看_国产精品一区二区久久精品_欧美老女人bb
国产日韩精品视频| 国产一区二区黑人欧美xxxx| 久久精品一本久久99精品| 欧美有码在线观看视频| 欧美裸身视频免费观看| 久久久av亚洲男天堂| 成人有码视频在线播放| 成人免费自拍视频| 日韩欧美视频一区二区三区| 亚洲国产精品久久久| 国产精品精品久久久| 亚洲激情久久久| 91精品国产乱码久久久久久久久| 中文字幕欧美视频在线| 91精品国产综合久久香蕉的用户体验| 91欧美精品成人综合在线观看| 日本午夜精品理论片a级appf发布| 一本大道香蕉久在线播放29| 欧美中文字幕在线播放| 成人国产在线激情| 久久久久久美女| 欧美大胆在线视频| 亚洲一区美女视频在线观看免费| 精品香蕉一区二区三区| 成人免费淫片aa视频免费| 亚洲综合小说区| 日韩精品福利在线| 91亚洲国产成人精品性色| 欧美成人在线网站| 精品无人区乱码1区2区3区在线| 国产午夜精品免费一区二区三区| 欧美黑人性猛交| 狠狠爱在线视频一区| 亚洲精品suv精品一区二区| 亚洲色图校园春色| 成人免费福利在线| 日韩在线观看免费高清完整版| 欧美大片欧美激情性色a∨久久| 狠狠躁夜夜躁人人爽超碰91| 日韩一区二区精品视频| 欧美乱大交xxxxx另类电影| 国产在线精品成人一区二区三区| 成人写真视频福利网| 亚洲天堂影视av| 国产精品高潮在线| 欧美性猛交xxxx偷拍洗澡| 日韩欧美在线视频日韩欧美在线视频| 亚洲人成在线观看| 亚洲国产精品视频在线观看| 日韩中文理论片| 国产91av在线| 亚洲白拍色综合图区| 国产成人精品视频| 欧美中文在线字幕| 国产精品av在线播放| 中文字幕在线看视频国产欧美| 91免费高清视频| 国产精品h在线观看| 日韩毛片中文字幕| 国产亚洲精品久久久| 欧美诱惑福利视频| 日韩av资源在线播放| 欧美麻豆久久久久久中文| 国产在线高清精品| 韩剧1988在线观看免费完整版| 91亚洲国产成人精品性色| 色综合天天狠天天透天天伊人| 国产精品欧美日韩| 亚洲欧美日韩第一区| 欧美激情视频在线| 日韩精品免费在线视频观看| 日韩网站在线观看| 清纯唯美亚洲激情| 一区二区在线视频播放| 国产99视频在线观看| 92福利视频午夜1000合集在线观看| 日本精品久久久久久久| 91av视频在线免费观看| 久久久之久亚州精品露出| 国模精品一区二区三区色天香| 亚洲第一精品夜夜躁人人爽| 久久这里有精品视频| 欧美丝袜一区二区三区| 91sao在线观看国产| 亚洲第一免费播放区| 97视频在线看| 亚洲a在线观看| 国产精品视频自在线| 国产精品成熟老女人| 91大神在线播放精品| 中文字幕亚洲欧美一区二区三区| 亚洲一区二区国产| 国产99久久精品一区二区永久免费| 日韩大陆欧美高清视频区| 在线视频日本亚洲性| 欧美与黑人午夜性猛交久久久| 色综合久综合久久综合久鬼88| 4388成人网| 欧美激情中文字幕乱码免费| 一区二区在线免费视频| 国产精品久久久久久久久久东京| 九九热r在线视频精品| 国产一区二区三区三区在线观看| 91在线视频一区| 热久久这里只有精品| 亚洲欧美成人在线| 久久久国产一区二区| 91热福利电影| 国产综合在线视频| 亚洲精品一区中文字幕乱码| 久久的精品视频| 亚洲女成人图区| 亚洲人成电影在线| 日韩欧美国产视频| 色七七影院综合| 国产精品久久久久7777婷婷| 国产欧美 在线欧美| 亚洲精品在线观看www| 超在线视频97| 亚洲午夜av电影| 中文字幕亚洲字幕| 精品国产欧美一区二区五十路| 国产精品免费观看在线| 日韩天堂在线视频| 日韩美女av在线免费观看| 综合网日日天干夜夜久久| 91精品国产乱码久久久久久久久| 亚洲免费影视第一页| 亚洲精品国产拍免费91在线| 成人av资源在线播放| 国产精品国产福利国产秒拍| 国产999精品久久久| 亚洲一区二区在线| 亚洲大胆人体视频| 久久精品国产91精品亚洲| 日韩不卡在线观看| 欧美在线观看日本一区| 国产有码在线一区二区视频| 91网站在线看| 国内精品一区二区三区四区| 伊人男人综合视频网| 久久久久久久999| 国产精品美女网站| 欧美电影院免费观看| 日韩激情在线视频| 国产一区二区在线播放| 日韩欧美亚洲范冰冰与中字| 日韩一区二区欧美| 亚洲精品免费av| 色av吧综合网| 欧美精品免费在线| 久久全球大尺度高清视频| 91精品视频专区| 日韩欧美中文字幕在线观看| 国产精品va在线播放| 国产精品999| 久久久久女教师免费一区| 亚洲最大的av网站| 国产综合香蕉五月婷在线| 欧美成人黄色小视频| 久久久精品2019中文字幕神马| 国产精品国产自产拍高清av水多| 国产精品激情av电影在线观看| 欧美激情欧美狂野欧美精品|