自己總結的C#編碼規範--6.格式篇

來源:互聯網
上載者:User

標籤:style   blog   http   color   使用   io   檔案   for   

 

  • 格式

格式的統一使用可以使代碼清晰、美觀、方便閱讀。為了不影響編碼效率,在此只作如下規定:

  • 長度
    1. 一個檔案最好不要超過500行(除IDE自動產生的類)。
      1. 一個檔案必須只有一個命名空間,嚴禁將多個命名空間放在一個檔案裡。
      2. 一個檔案最好只有一個類。
      3. 如果超過500行,考慮拆分類或者使用Partial 類將類按照功能拆分。
    2. 一個方法的代碼最好不要超過50行,如果超過考慮將裡面的邏輯封裝成函數。
  • 空格、空行

空行的使用以使代碼清晰為為基本原則。空行影響程式的運行,但可以使代碼看起來清晰,增加可讀性,因此可以適當的使用。

  1. 方法與方法之間有兩個空行
  2. 函數內部變數聲明與函數內部邏輯之間有一個空行。
  3. 函數內部一個邏輯完成後要有一個空行,然後再寫下一個邏輯
  • 換行

換行掌握的原則是不要使一行代碼特別長,以方便讀者快速閱讀。

  1. 請團隊所有成員開啟Visual Studio自動換行功能。

    Tools->Options->Text Editor->C#->Check the Word wrap CheckBox

  2. 在不產生嚴重歧義或增加閱讀難度的情況下,盡量控制在80列以內,不能超過120列,以方便閱讀和代碼的列印。
  3. 另外換行的原則是,在逗號後,操作符前換行,換行與首行要保持一個單位的縮排。
  4. "{"和"}"必須單獨在一行上,且上下對齊。
  5. If,while,do,try-catch-finaly 等語句後必須有{},即使裡面只有一條語句或語句為空白,且遵循"{"和"}"必須單獨在一行上上的規定。

     

  • Region的使用

Region的使用可以明確代碼塊的範圍並提供相應注釋,因此提倡大家盡量使用。

同時Region也可以用來組織代碼結構,我們使用以下Region約定來使組織類:

  1. 一個類應該用Region劃分出Fields、Properties、Constructor、Private Methods和 Protected & Public Methods 五個地區。並按照上述順序從上到下排列。
  2. 其中Fields、Properties、Constructor、Private Methods必須放在Region。而Protected & Public Methods 必須放在外面。Protected & Public Methods 是代碼閱讀者尋找最頻繁的內容,這樣做可以方便代碼閱讀者使用Ctrl+M, O時能夠最快速度定位到自己想要尋找的內容。

一個好的類結構第一層展開時應該如所示:

  • 使用VS的Format Document功能

一個類或者方法編寫完成後,必須使用Visual Studio 內建的"Format Document"的功能進行排版後才能Check In.

相關文章

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.