基本註釋規範

1     規範目的

1. 一個軟件的生命週期中，80%的花費在於維護；
2. 幾乎沒有任何一個軟件，在其整個生命週期中，均由最初的開發人員來維護；
3. 編碼規範能夠改善軟件的可讀性，能夠讓程序員儘快而完全地理解新的代碼。爲了執行規範，每一個軟件開發人員必須一致遵照編碼規範；
4. 使用統一編碼規範的主要緣由，是使應用程序的結構和編碼風格標準化，以便於閱讀和理解這段代碼；
5. 好的編碼約定可以使源代碼嚴謹、可讀性強且意義清楚，與其它語言約定相一致，而且儘量的直觀。

2    例子

        

3    方法註釋規範

           ///<summary>

           ///說明：<對該方法的說明>

           ///</summary>

          ///<paramname="<參數名稱>"><參數說明></param>

          ///<returns>

          ///<對方法返回值的說明，該說明必須明確說明返回的值表明什麼含義>

          ///</returns>

 4     類註釋規範

          ///<summary>

         ///屬性說明

         ///</summary>

5    單行多行註釋

         一、單行註釋。格式：// 更改用戶姓名

         二、多行註釋。格式：/* 更改用戶姓名... */

6    命名規則

        1. 要採用大小寫混合，提升名字的可讀性。爲區分一個標識符中的多個單詞，把標識符中的每一個單詞的首字母大寫。不採用下劃線做分隔字符的寫法。

　　　　有兩種適合的書寫方法，適應於不一樣類型的標識符：

　　　　　一、PasalCasing：標識符的第一個單詞的字母大寫；

　　　　　二、camelCasing：標識符的第一個單詞的字母小寫。

         2.  下表描述了不一樣類型標識符的大小寫規則：