C#語言規范有哪些

這篇文章主要講解了“C#語言規范有哪些”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“C#語言規范有哪些”吧！

C#語言規范——注釋規范

a）文件頭部注釋

【規則1-1】文件都包含文件頭，要說明文件名、作者、創建時間、變更記錄。

【規則1-2】推薦采用.NET形式書寫頭部注釋。

b）類及其成員注釋

【規則2-1】對方法和類使用“///”三斜線注釋。

【規則2-2】代碼行文注釋采用“//”和“”進行， 應該盡量說明問題。

C#語言規范——行文規范

a）縮寫規范

【規則1-1】標識符應當直觀可望文知意，不提倡使用任何縮寫。

【規則1-2】字符串變量推薦是用“str”或“s”開頭，采用string.Empty來初始化。

【規則1-3】普通對象可以以“obj”開頭。

【規則1-4】縮寫可自行定義，一般取單詞的前/后字符組成，以含義直觀為準則。

【規則1-5】一般情況下不要讓縮寫破壞標識符的含義。

b）排版

【規則2-1】每行語句至少占一行，如果語句過長（超過一屏），則該語句斷為兩行顯示。

【規則2-2】把相似的內容放在一起，比如字段、屬性、方法、事件等，使用“#region--#endregion”命令分組。

【規則2-3】多個程序元素進行對等操作是，操作符之前、之后或者前后都要加空格。

【規則2-4】每個方法的源程序行數原則上應該少于200行。

【規則2-5】語句嵌套層次不得超過3層。

【規則2-6】避免相同的代碼段在多個地方出現。

c）語句結構

【規則3-1】如果使用了異常結構，一定要處理異常，一般是要寫日志文件。

【規則3-2】分支語句不應該使用復雜長條件，應該將長條件封裝成方法。

【規則3-3】switch語句，case后面必須接break。

【規則3-4】禁止使用goto語句進行跳轉。

【規則3-5】行文中嚴禁出現“魔數”，特定含義的常數必須定義成枚舉或常量。

【規則3-6】不同類型的操作符混合使用時，使用括號給出優先級。

【規則3-7】不允許使用復雜的操作符組合等。

【規則3-8】循環、判斷語句的程序塊部分用花括號括起來，即使只有一條語句。

【規則3-9】在switch語句中總是要有default字句，建議使用斷言。

【規則3-10】每個類和方法完成單一的功能，不設計多用途面面俱到的類或方法。

【規則3-11】嚴禁使用未經初始化的變量，變量通常使用構造方法來初始。

d）代碼縮進

【規則4-1】碰到大括號要換行。

【規則4-2】不允許使用Java中的括號換行規范。

e）大小寫

【規則5-1】不要創建名稱相同，但大小寫區別的任何元素。

【規則5-2】應當大寫僅有兩個字符的縮寫。

【規則5-3】不要把易混淆的數字和字符放在一起。

【規則5-4】使用英文命名標識符。

f）重名規范

【規則6-1】不允許變量名、類名、屬性名、方法名等與系統標識符重名。（系統標識符見附表）

g）SQL編碼規范

【規則7-1】SQL語句全部大寫。

【規則7-2】對較為復雜的SQL語句加上注釋，說明其功能。

【規則7-3】連接符OR、IN、AND、以及=、< =、>=等前后加空格。

【規則7-4】使用明確的列代替 SELECT *。

h）軟件架構

【規則8-1】數據庫中每一張表對應一個實體類/數據傳輸對象（DTO）。

【規則8-2】實體類名稱使用表名，也可帶有Dto后綴。

【規則8-3】三層架構應當合理使用，不應生搬硬套。

【規則8-4】三層架構元素推薦使用后綴：

數據傳輸對象       XxxxDto

DAO工廠                XxxDAOFactory

DAO接口                IXxxxDAO

服務接口           IxxxxService

DAO的數據庫實現        XxxxDAOOracle/XxxxDAOInfomix

業務邏輯           XxxxManager

i）系統

【規則9-1】在國內不要隨便使用設計模式等代碼模式，因為并不流行。

【規則9-2】系統輸入、資源操作（如內存分配、文件及目錄操作）、網絡操作（如通信、調用等）、任務間的操作（如通信、調用等）時必須進行錯誤、超時、或則異常處理。

【規則9-3】模塊編寫應該有完善的測試方面的考慮。

感謝各位的閱讀，以上就是“C#語言規范有哪些”的內容了，經過本文的學習后，相信大家對C#語言規范有哪些這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！