C#編程規范和慣例

2024-07-21 02:27:00

字體：大中小

來源：轉載

供稿：網友

誰都會寫代碼！幾個月的編程經驗可以讓你寫出“可運行應用程序”。讓它可運行容易，但是以最有效率的方式編碼就需要下更多的功夫！

要知道，大多數程序員在寫”可運行代碼，“而不是”高效代碼“。我們在這個指南課程前面提到，你想成為你們公司”最尊貴的專業人員“嗎？寫”高效代碼“是一項藝術，你必須學習和實踐它。

命名慣例和規范

注記 :
pascal 大小寫形式－所有單詞第一個字母大寫，其他字母小寫。
camel 大小寫形式－除了第一個單詞，所有單詞第一個字母大寫，其他字母小寫。

類名使用pascal 大小寫形式

public class helloworld{ ...}

方法使用pascal 大小寫形式

public class helloworld{ void sayhello(string name) {  ... }}

變量和方法參數使用camel 大小寫形式

public class helloworld{ int totalcount = 0; void sayhello(string name) {  string fullmessage = "hello " + name;  ... }}

不要使用匈牙利方法來命名變量

以前，多數程序員喜歡它－把數據類型作為變量名的前綴而m_作為成員變量的前綴。例如：

string m_sname;int nage;

然而，這種方式在.net編碼規范中是不推薦的。所有變量都用camel 大小寫形式，而不是用數據類型和m_來作前綴。

用有意義的，描述性的詞語來命名變量

- 別用縮寫。用name, address, salary等代替 nam, addr, sal
- 別使用單個字母的變量象i, n, x 等. 使用 index, temp等
用于循環迭代的變量例外：

for ( int i = 0; i < count; i++ ){ ...}

如果變量只用于迭代計數，沒有在循環的其他地方出現，許多人還是喜歡用單個字母的變量(i) ，而不是另外取名。
- 變量名中不使用下劃線 (_) 。
- 命名空間需按照標準的模式命名

...

文件名要和類名匹配

例如，對于類helloworld, 相應的文件名應為 helloworld.cs (或, helloworld.vb)

縮進和間隔

縮進用 tab . 不用 spaces.。

注釋需和代碼對齊.。

花括弧 ( {} ) 需和括號外的代碼對齊.。

用一個空行來分開代碼的邏輯分組。.

 bool sayhello (string name) {  string fullmessage = "hello " + name;  datetime currenttime = datetime.now;  string message = fullmessage + ", the time is : " + currenttime.toshorttimestring();  messagebox.show ( message );  if ( ... )  {   // do something   // ...   return false;  }  return true; }

這段代碼看起來比上面的好：:

 bool sayhello ( string name ) {  string fullmessage = "hello " + name;  datetime currenttime = datetime.now;  
  string message = fullmessage + ", the time is : " + currenttime.toshorttimestring();  
  messagebox.show ( message );  
  if ( ... )  {   // do something   // ...   
   return false;  }  
  return true; }

在一個類中，各個方法需用一空行，也只能是一行分開。

花括弧需獨立一行，而不象if, for 等可以跟括號在同一行。.
好：

  if ( ... )   {   // do something  }

不好：

  if ( ... ) {   // do something  }

在每個運算符和括號的前后都空一格。.

好：

  if ( showresult == true )  {   for ( int i = 0; i < 10; i++ )   {    //   }  }

不好：

  if(showresult==true)  {   for(int i= 0;i<10;i++)   {    //   }  }

良好的編程習慣

遵從以下良好的習慣以寫出好程序

避免使用大文件。如果一個文件里的代碼超過300～400行，必須考慮將代碼分開到不同類中。

避免寫太長的方法。一個典型的方法代碼在1～25行之間。如果一個方法發代碼超過25行，應該考慮將其分解為不同的方法。

方法名需能看出它作什么。別使用會引起誤解的名字。如果名字一目了然，就無需用文檔來解釋方法的功能了。

好：

 void savephonenumber ( string phonenumber ) {  // save the phone number. }

不好：

 // this method will save the phone number. void savedata ( string phonenumber ) {  // save the phone number. }

一個方法只完成一個任務。不要把多個任務組合到一個方法中，即使那些任務非常小。

好：

 // save the address. saveaddress (  address );  // send an email to the supervisor to inform that the address is updated. sendemail ( address, email );    void saveaddress ( string address ) {  // save the address.  // ... }  void sendemail ( string address, string email ) {  // send an email to inform the supervisor that the address is changed.  // ... }

不好：

 // save address and send an email to the supervisor to inform that the address is updated. saveaddress ( address, email ); void saveaddress ( string address, string email ) {  // job 1.  // save the address.  // ...  // job 2.  // send an email to inform the supervisor that the address is changed.  // ... }

使用c# 或 vb.net的特有類型，而不是system命名空間中定義的別名類型。

好：

 int age; string name; object contactinfo;

不好：

 int16 age; string name; object contactinfo;

別在程序中使用固定數值，用常量代替。

別用字符串常數。用資源文件。

避免使用很多成員變量。聲明局部變量，并傳遞給方法。不要在方法間共享成員變量。如果在幾個方法間共享一個成員變量，那就很難知道是哪個方法在什么時候修改了它的值。

必要時使用enum 。別用數字或字符串來指示離散值。
好：

 enum mailtype {  html,  plaintext,  attachment } void sendmail (string message, mailtype mailtype) {  switch ( mailtype )  {   case mailtype.html:    // do something    break;   case mailtype.plaintext:    // do something    break;   case mailtype.attachment:    // do something    break;   default:    // do something    break;  } }

不好：

 void sendmail (string message, string mailtype) {  switch ( mailtype )  {   case "html":    // do something    break;   case "plaintext":    // do something    break;   case "attachment":    // do something    break;   default:    // do something    break;  } }

別把成員變量聲明為 public 或 protected。都聲明為 private 而使用 public/protected 的properties.

不在代碼中使用具體的路徑和驅動器名。使用相對路徑，并使路徑可編程。

永遠別設想你的代碼是在“c:”盤運行。你不會知道，一些用戶在網絡或“z:”盤運行程序。

應用程序啟動時作些“自檢”并確保所需文件和附件在指定的位置。必要時檢查數據庫連接。出現任何問題給用戶一個友好的提示。

如果需要的配置文件找不到，應用程序需能自己創建使用默認值的一份。

如果在配置文件中發現錯誤值，應用程序要拋出錯誤，給出提示消息告訴用戶正確值。

錯誤消息需能幫助用戶解決問題。永遠別用象"應用程序出錯", "發現一個錯誤" 等錯誤消息。而應給出象 "更新數據庫失敗。請確保登陸id和密碼正確。" 的具體消息。

顯示錯誤消息時，除了說哪里錯了，還應提示用戶如何解決問題。不要用象 "更新數據庫失敗。"這樣的，要提示用戶怎么做："更新數據庫失敗。請確保登陸id和密碼正確。"

顯示給用戶的消息要簡短而友好。但要把所有可能的信息都記錄下來，以助診斷問題。

注釋

別每行代碼，每個聲明的變量都做注釋。

在需要的地方注釋。可讀性強的代碼需要很少的注釋。如果所有的變量和方法的命名都很有意義，會使代碼可讀性很強并無需太多注釋。

行數不多的注釋會使代碼看起來優雅。但如果代碼不清晰，可讀性差，那就糟糕。

如果應為某種原因使用了復雜艱澀的原理，為程序配備良好的文檔和重分的注釋。

對一個數值變量采用不是0,-1等的數值初始化，給出選擇該值的理由。

簡言之，要寫清晰，可讀的代碼以致無須什么注釋就能理解。

對注釋做拼寫檢查，保證語法和標點符號的正確使用。

異常處理

不要“捕捉了異常卻什么也不做“。如果隱藏了一個異常，你將永遠不知道異常到底發生了沒有。

發生異常時，給出友好的消息給用戶，但要精確記錄錯誤的所有可能細節，包括發生的時間，和相關方法，類名等。

只捕捉特定的異常，而不是一般的異常。

好：

 void readfromfile ( string filename ) {  try  {   // read from file.  }  catch (fileioexception ex)  {   // log error.   //  re-throw exception depending on your case.   throw;  } }

不好：

 void readfromfile ( string filename ) {  try  {   // read from file.  }  catch (exception ex)   {   // catching general exception is bad... we will never know whether it   // was a file error or some other error.      // here you are hiding an exception.    // in this case no one will ever know that an exception happened.   return "";    } }

不必在所有方法中捕捉一般異常。不管它，讓程序崩潰。這將幫助你在開發周期發現大多數的錯誤。

你可以用應用程序級（線程級）錯誤處理器處理所有一般的異常。遇到”以外的一般性錯誤“時，此錯誤處理器應該捕捉異常，給用戶提示消息，在應用程序關閉或用戶選擇”忽略并繼續“之前記錄錯誤信息。

不必每個方法都用try-catch。當特定的異常可能發生時才使用。比如，當你寫文件時，處理異常fileioexception.

別寫太大的 try-catch 模塊。如果需要，為每個執行的任務編寫單獨的 try-catch 模塊。這將幫你找出哪一段代碼產生異常，并給用戶發出特定的錯誤消息

如果應用程序需要，可以編寫自己的異常類。自定義異常不應從基類systemexception派生，而要繼承于. iapplicationexception。

，歡迎訪問網頁設計愛好者web開發。

上一篇：在C#中運用SQLDMO備份和恢復SQL Server數據庫

下一篇：C#文本框輸入內容限制（1）：數字輸入