時(shí)間:2015-06-28 00:00:00 來源:IT貓撲網(wǎng) 作者:網(wǎng)管聯(lián)盟 我要評(píng)論(1)
以下是本人對(duì).Net平臺(tái)開發(fā)實(shí)踐的一些點(diǎn)滴總結(jié)。這里的技術(shù)規(guī)范主要是開發(fā)過程的代碼規(guī)范、數(shù)據(jù)庫(kù)設(shè)計(jì)規(guī)范、Com和.Net互操作規(guī)范;實(shí)踐精華是對(duì)技術(shù)實(shí)踐過程中的部分總結(jié)。
一、代碼規(guī)范
良好的代碼風(fēng)格來自于同一的代碼規(guī)范。風(fēng)格良好的代碼不僅具備可讀性和可維護(hù)性,同時(shí)也給人行云流水、賞心悅目之快感。
據(jù)Microsoft公司統(tǒng)計(jì),基于微軟平臺(tái)的開發(fā)中,有70-80%的印度工程師在完成同類算法或者模塊時(shí),使用的代碼基本一致;而相同的調(diào)查中只有20%的中國(guó)工程師們是基本一致的。這說明我們的代碼生產(chǎn)過程亟待規(guī)范。
實(shí)義命名
類型、變量、常量、方法等標(biāo)識(shí)符一律采用對(duì)應(yīng)的英文實(shí)義;如果涉及到兩個(gè)獨(dú)立的實(shí)義單詞,則中間用下劃線間隔或者單詞首字母大寫(兩種方式都可以);如果標(biāo)識(shí)符的長(zhǎng)度超過了30個(gè)字母,則基本上以英文單詞發(fā)音的重讀音節(jié)取選出三個(gè)字母,如Repeater用rpt,Management用mgt。
大小寫規(guī)則
目前一般有兩種大小寫規(guī)則:
Pascal大小寫形式,所有單詞第一個(gè)字母大寫,其他字母小寫。
Camel大小寫形式,除了第一個(gè)單詞,所有單詞第一個(gè)字母大寫,其他字母小寫。
類名使用Pascal大小寫形式
public class HelloWorld(或者Hello_World,以下同,不再贅述) { ... } |
方法使用Pascal大小寫形式
public class HelloWorld() { void SayHello(string name) { ... } } |
變量和方法參數(shù)使用Camel 大小寫形式
public class HelloWorld() { int totalCount = 0; void SayHello(string name) { string fullMessage = "Hello " + name; ... } } |
不要使用匈牙利方法來命名變量
以前,多數(shù)程序員喜歡把數(shù)據(jù)類型作為變量名的前綴而m_作為成員變量的前綴。例如: string m_sName;int nAge;
然而,這種方式在.NET編碼規(guī)范中是不推薦的。所有變量都用Camel 大小寫形式,而不是用數(shù)據(jù)類型和m_來作前綴。
用name,address,salary等代替nam,addr,sal。
別使用單個(gè)字母的變量象i,n,x 等。使用 index,temp等。用于循環(huán)迭代的變量例外:
如果變量只用于迭代計(jì)數(shù),沒有在循環(huán)的其他地方出現(xiàn),允許用單個(gè)字母的變量命名,而不是另外取實(shí)義名。
文件名要和類名匹配,例如,對(duì)于類HelloWorld,相應(yīng)的文件名應(yīng)為helloworld.cs。
縮進(jìn)和間隔
縮進(jìn)用TAB,不用 SPACES。
注釋需和代碼對(duì)齊。
遵循VS2005的自動(dòng)對(duì)齊規(guī)則,不要人為的調(diào)整。
用一個(gè)空行來分開代碼的邏輯分組。
在一個(gè)類中,各個(gè)方法的實(shí)現(xiàn)體必須用空行間隔,大括弧"{}"需獨(dú)立一行。
在每個(gè)運(yùn)算符和括號(hào)的前后都空一格。如:
If ( showResult == true ) { for ( int i = 0; i < 10; i++ ) { // } } |
而不是:
if(showResult==true) { for(int i= 0;i<10;i++) { // } } |
良好的編程習(xí)慣
避免使用大文件。如果一個(gè)文件里的代碼超過300~400行,必須考慮將代碼分開到不同類中。
避免寫太長(zhǎng)的方法。一個(gè)典型的方法代碼在1~30行之間。如果一個(gè)方法發(fā)代碼超過30行,應(yīng)該考慮將其分解為不同的方法。
方法名需能看出它作什么。別使用會(huì)引起誤解的名字。如果名字一目了然,就無需用文檔來解釋方法的功能了。
一個(gè)方法只完成一個(gè)任務(wù)。不要把多個(gè)任務(wù)組合到一個(gè)方法中,即使那些任務(wù)非常小。
使用C# 的特有類型,而不是System命名空間中定義的別名類型。如:
int age; string name; object contactInfo; |
而不是:
Int16 age; String name; Object contactInfo; |
這么做是基于如下兩點(diǎn)原因:(1)規(guī)范性和一致性;(2)便于跨語(yǔ)言平臺(tái)的移植。
別在程序中使用固定數(shù)值,用常量代替。別用字符串常數(shù),盡量用資源文件。
避免使用很多成員變量,聲明局部變量,并傳遞給方法。
不要在方法間共享成員變量,如果在幾個(gè)方法間共享一個(gè)成員變量,那就很難知道是哪個(gè)方法在什么時(shí)候修改了它的值。必要時(shí)使用enum,別用數(shù)字或字符串來指示離散值。
別把成員變量聲明為 public或 protected。都聲明為private 而使用 public/protected 的Properties。
不在代碼中使用具體的路徑和驅(qū)動(dòng)器名,使用相對(duì)路徑,并使路徑可編程。永遠(yuǎn)別設(shè)想你的代碼是在"C:"盤運(yùn)行。你不會(huì)知道,一些用戶在網(wǎng)絡(luò)或"Z:"盤運(yùn)行程序。
應(yīng)用程序啟動(dòng)時(shí)作些"自檢"并確保所需文件和附件在指定的位置。必要時(shí)檢查數(shù)據(jù)庫(kù)連接,出現(xiàn)任何問題給用戶一個(gè)友好的提示。
如果需要的配置文件找不到,應(yīng)用程序需能自己創(chuàng)建使用默認(rèn)值。如果在配置文件中發(fā)現(xiàn)錯(cuò)誤值,應(yīng)用程序要拋出錯(cuò)誤,給出提示消息告訴用戶正確值。錯(cuò)誤消息需能幫助用戶解決問題。
注釋
別每行代碼,每個(gè)聲明的變量都做注釋。在需要的地方注釋。
可讀性強(qiáng)的代碼需要很少的注釋,如果所有的變量和方法的命名都很有意義,會(huì)使代碼可讀性很強(qiáng)并無需太多注釋。行數(shù)不多的注釋會(huì)使代碼看起來優(yōu)雅。
如果因?yàn)槟撤N原因使用了復(fù)雜艱澀的原理,必須為程序配備良好的文檔和詳細(xì)的注釋。
對(duì)注釋做拼寫檢查,保證語(yǔ)法和標(biāo)點(diǎn)符號(hào)的正確使用。
二、數(shù)據(jù)庫(kù)設(shè)計(jì)規(guī)范
表格分類與命名
數(shù)據(jù)表的分類關(guān)鍵詞標(biāo)簽:.Net平臺(tái)開發(fā)規(guī)范
相關(guān)閱讀
熱門文章 誅仙3飛升任務(wù)怎么做-誅仙3飛升任務(wù)流程最新2022 鐘離圣遺物推薦-原神鐘離圣遺物詞條 解決方法:應(yīng)用程序“DEFAULT WEB SITE”中的服務(wù)器錯(cuò)誤 使用aspnet_regiis.exe 重新注冊(cè).NET Framework
人氣排行 誅仙3飛升任務(wù)怎么做-誅仙3飛升任務(wù)流程最新2022 asp.net表單提交方法GET\POST 在ASP.NET中如何判斷用戶IE瀏覽器的版本 Asp.net中messagebox的實(shí)現(xiàn)方法 Asp.net中的web.config配置 在ASP.NET MVC中實(shí)現(xiàn)大文件異步上傳 asp.net獲取URL和IP地址 FileUpload上傳多文件出現(xiàn)錯(cuò)誤的解決方法