《c和ui規(guī)范》ppt課件-全文預(yù)覽
【正文】 構(gòu)體類型命名必須全部用大寫字母 ,原則上前面 以下劃線開始 。 ? public class SampleClass ? { ? public Color BackColor ? { ? // Code for Get and Set accessors goes here. ? } ? } ? 以下代碼示例闡釋提供其名稱與類型相同的屬性。 ? 4 考慮 用與屬性的基礎(chǔ)類型相同的名稱創(chuàng)建屬性 。 ?以下是正確命名的參數(shù)的示例。 ? 不要使用保留的參數(shù) 。 ? 使用描述參數(shù)的含義的名稱 ，而不要使用描述參數(shù)的類型的名稱。 ? 5 總是將 FlagsAttribute 添加到位域 Enum 類型 。以下規(guī)則概枚舉的命名指南： ? 1 對于 Enum 類型和值名稱 使用 Pascal 大小寫 。 ? public interface IServiceProvider ? public interface IFormatable ? 以下代碼示例闡釋 如何定義 IComponent 接口及其標(biāo)準(zhǔn)實現(xiàn) Component 類 。 ? 不要使用下劃線字符 (_)。 ? 少用縮寫 。 例如，接口名稱 IComponent 使用描述性名詞。 請在應(yīng)用該規(guī)則時進(jìn)行合理的判斷。例如， 類名稱 IdentityStore 是適當(dāng)?shù)?。例如，使用類名稱 FileStream，而不是 CFileStream。 ? } ? } ? public int Y ? { ? get ? { ? return y。 ? int y。 ? 以下示例闡釋具有適當(dāng)名稱和參數(shù)的事件處理程序。 ? 6 、 不要在類型的事件聲明上使用前綴或者后綴 。 ? 考慮 用動詞命名事件 。 sender 參數(shù)始終是 object 類型的，即使在可以使用更為特定的類型時也如此。 ? 3 以下是正確命名的方法的實例。 第一個字母必須使用大寫字母 ,要求用大小寫字母組合規(guī)范函數(shù)命名 ,必要時可用下劃線間隔 ,示例如下： ? void PrintTrackData ( )。 ? TechnologyName 指的是該項目的 英文縮寫，或軟件名。 ? 常量和宏定義必須 全部以大寫字母 來撰寫 ,中間可根據(jù)意義的連續(xù)性 用下劃線連接 ,每一條定義的右側(cè) 必須有一簡單的注釋 ,說明其作用 ?？赡艿那闆r下，盡量不要使用原義數(shù)字或原義字符串，如 For i = 1 To 7。狀態(tài)變量不同于布爾變量的地方是它可以具有兩個以上的可能值。 ? 只要合適 ， 在變量名的末尾或開頭加計算限定符（ Avg、 Sum、 Min、 Max、 Index）。 ? 以下幾點是推薦的命名方法： ? 避免容易被主觀解釋的難懂的名稱 ，如方面名 AnalyzeThis()，或者屬性名 xxK8。使名稱足夠長以便有一定的意義，并且足夠短以避免冗長。 ? 引用一 : 文件開頭的注釋模板 /****************************************************************** ** 文件名 : ** Copyright (c) 鄭州銳升軟件技術(shù)有限公司 ** 創(chuàng)建人 : ** 日 期 : ** 修改人 : ** 日 期 : ** 描 述 : ** ** 版 本 : ** ? 引用二 : 函數(shù)開頭的注釋模板 ? /// summary ? /// ? /// /summary ? /// param name=/param ? /// param name=/param ? /// author/author ? /// date/date ? /// version/version 引用三 : 程序中的注釋模板 /**/ /* 注釋內(nèi)容 */ /**/ 第四小節(jié) 命名 ? 名稱應(yīng)該說明“什么”而不是“如何”。 第三小節(jié) 注釋 ? 原則上注釋要求 使用中文 。 第二小節(jié) 程序 ? ， 結(jié)構(gòu)清晰 ，避免太多的分支結(jié)構(gòu)及太過于技巧性的程序， 盡量不采用遞歸模式 。 ? 6 盡量 不要比較浮點數(shù)的相等 ，如： * == ， 不可靠 7 程序與環(huán)境或狀態(tài)發(fā)生關(guān)系時，必須主動去處理發(fā)生的意外事件，如文件能否邏輯鎖定、打印機(jī)是否聯(lián)機(jī)等 ,對于明確的錯誤 ,要有明確的容錯代碼提示用戶，在這樣 不確定的場合都使用 Try Throw Catch。 ? 9 不要輕易用條件分支 去替換邏輯表達(dá)式 ? 正確性與容錯性要求： ? 1 程序 首先是正確 ，其次是優(yōu)美 ? 2 無法證明你的程序沒有錯誤，因此在編寫完一段程序后，應(yīng)先 回頭檢查 。 ? 5 避免 從循環(huán)引出 多個出口 。 ? 2 除了 在 Switch關(guān)鍵字的作用域內(nèi)， 禁止 GOTO語句 。 ? 11. 空行和空白字符也是一種特殊注釋。 ? 7 .在 典型算法前都有注釋 , 同時算法在滿足要求的情況下盡可能簡單。 ? 3 .每個源程序文件，都 有文件頭說明 ，說明規(guī)格見規(guī)范。 ? .NET庫函數(shù)和公共函數(shù) (無特殊情況不要使用外部方法調(diào)用 windows的核心動態(tài)鏈接庫API)。 ? ，要簡單，直截了當(dāng)， 代碼精簡 ，避免垃圾程序。 ? 2. 保持 注釋與代碼完全一致 。 ? 6 .處理過程的每個階段都 有相關(guān)注釋說明 。 ? 10. 注釋 可以與語句在 同一行 ，也可以在 上行 。 ? 14. 注釋行數(shù) （不包括程序頭和函數(shù)頭說明部份）應(yīng)占 總行數(shù)的 1/5 到 1/3 ? ： ? 1 禁止 出現(xiàn)兩條 等價的支路 。 ? 4 用 CASE 實現(xiàn) 多路分支 。 ? 8 避免 不必要的分支。 ? 5 對所有的 用戶輸入 ，必須進(jìn)行 合法性檢查 。 ? 2 考慮 OO思想 ，減少外界聯(lián)系，考慮獨立性或封裝性 。 ? 比較大的函數(shù) ，每個 block 和特殊的函數(shù)調(diào)用，都 必須注明其功能 。 ? 程序中注釋包括 :修改時間和作者、方便理解的注釋等 。 ? 命名原則是： ? 選擇正確名稱時的困難可能表明需要進(jìn)一步分析或
教學(xué)課件相關(guān)推薦
鄂ICP備17016276號-1