【正文】 比如，考慮在C代碼內手動寫入 tryfinally 塊:TextReader tr = new StreamReader（（））。// C sample:public void Dispose（）{ Dispose（true）。用終結器 和 方法來調用該方法。比如，為存儲非托管內存的緩沖實現(xiàn)該模式。 （this）。例如 C/VB的 using 語句， C的lock語句， VB的SyncLock 語句， C的foreach語句以及VB For Each 語句。 一定請 使用 tryfinally 塊來清理資源， trycatch 塊來處理錯誤恢復。 一定請 在捕獲并重新拋出異常時，傾向使用throw 。 returns nullTry ...Catch e As ArgumentException _When （File） ...End Try253。}253。比如，如果傳遞了一個null實參，則拋出ArgumentNullException ，而不是其基類ArgumentException 。 一定請 在一站式代碼示例庫中使用 Visual Studio 創(chuàng)建的項目的默認的命名空間。靜態(tài)類應該被用于框架內基于對象的核心支持輔助類。但是比非虛方法在性能上低一點。 一定請僅將最長重載函數(shù)設為虛函數(shù) （為了拓展性考慮）。）。 成員方法重載254。如果驗證失敗，或者其子集：如果一個 null 實參傳遞給成員，而成員方法不支持null實參，則拋出ArgumentNullException。 這樣即使您增加了一個帶有參數(shù)的構造函數(shù)，也能確保默認構造函數(shù)仍然會被定義。 一定請 盡量減少構造函數(shù)的工作量。253。 屬性254。Public或Protected字段并沒有受到代碼訪問安全需求的保護。? 它不會引發(fā)頻繁的裝箱拆箱操作。 一定請為值類型實現(xiàn) IEquatableT 接口。 一定不要 返回數(shù)組或集合的null引用。除非Hashtable 只存儲少量值，最好不要使用Hashtable 。 一定請 將代表了讀/寫集合的屬性或返回值聲明為 CollectionT或其子類，將代表了只讀集合的屬性或返回值聲明為ReadOnlyCollectionT 或其子類。}254。, 39。 一定不要 使用只讀的數(shù)組字段。 數(shù)組和集合254。一個例外是當你堅持其語言上有意義，而與具體文化無關的情況。一般來說，需要調用帶有StringComparison類型參數(shù)的重載函數(shù)。然而，拼接少量的字符串時，一定請使用 ‘+’ 操作符（ ‘amp。 一定請 為預定義的對象實例使用public static （shared） readonly字段 。控件類型前綴ButtonbtnCheckBoxchkCheckedListBoxlstComboBoxcmbContextMenumnuDataGrid dgDateTimePickerdtpFormsuffix: XXXFormGroupBoxgrpImageListimlLabellbListBoxlstListViewlvwMenumnuMenuItemmnuNotificationIconnfyPanelpnlPictureBoxpct ProgressBarprgRadioButtonradSplittersplStatusBarstsTabControltabTabPagetabTextBox tbTimertmrTreeViewtvw比如，對于 “File | Save” 菜單選線， “Save” 菜單項應該命名為 “mnuFileSave”。T, TItem, TPolicy資源Pascal規(guī)范名詞254。public const double PI = ...。 254。 private string name。 一定請 以集合中項目的復數(shù)形式命名該集合，或者單數(shù)名詞后面跟 “List” 或者 “Collection”。253。 Microsoft Corporation 2010[assembly: AssemblyCopyright（Copyright 169。 文件和結構253。每一個代碼示例都必須完整，在代碼中不能有未完成的任務。當函數(shù)沒有輸出參數(shù)，或者只有一些單純作為輸出參數(shù)的情況下，無需交代理由。C 函數(shù)注釋模板:/// summary/// Function description/// /summary/// param name=Parameter name/// Parameter description/// /param/// returns/// Description of function return value/// /returns/// exception cref=Exception type/// Exception that may be thrown by the function/// /exception39。 項目，并帶有 /doc 命令時，編譯器會在源代碼中搜索 XML 標簽，并生成XML文檔。 }}254。 // Save its impact for parison pBestWrinkle = pWrinkle。如果每一行代碼都有注釋，便會影響到可讀性和可理解性。}當內聯(lián)注釋只為結構體，類成員變量，參數(shù)和短語句做描述時，則內聯(lián)注釋允許出現(xiàn)在和實際代碼的同一行。39。 即使注釋跨越多行代碼，單行注釋語法（// …）仍然是首選。這樣做使得將來增加條件式更簡便，并減少制表符引起的歧義。 一定請在一站式示例代碼庫的代碼示例中使用 Allman風格的大括號用法。Good: // C++ / C sample:CreateFoo（）。 if（...） { }}Bad: // C++ sample:void ProcessItem（const Itemamp。Bad: [Flags]public enum SomeFlag { ValueA = 0, // This might be confusing to users ValueB = 1, ValueC = 2, ValueBAndC = ValueB | ValueC,}SomeFlag flags = GetValue（）。 您應該 提供一些特殊的枚舉值，以便進行常見的標志枚舉的組合運算。} 標志枚舉 標志枚舉用于對枚舉值進行位運算的支持。 一定請 為簡單枚舉提供一個0值枚舉量，可以考慮將之命名為 “None”。枚舉類型是一個具有一個靜態(tài)常量集合的結構體。Good: // C sample:a = 1。 一定請 將參數(shù)排序，并首先將輸入?yún)?shù)分組，再將輸出參數(shù)放置最后。將返回值置于函數(shù)或方法名稱的同一行。 // Pointer of the first element.CodeExample *pSecond = NULL。 一定請 在語言允許的情況下，將局部變量的聲明和初始化或賦值置于同一行代碼內。這對于靜態(tài)變量同樣適用。 一定請 在您的代碼編輯器中使用定寬字體，例如 Courier New。所有代碼都應該使用4個空格來表示縮進。 一定請確保代碼的明確性，易讀性和透明性。該規(guī)范用于統(tǒng)一編程風格，保持一致和清晰的風格。術語意圖理由254。不允許展示入侵性或低質的編程實踐，不允許永久改變機器狀態(tài)。2. 正確性 – 示例代碼必須正確展示出其欲告知使用者的重點。任何指導準則都可能會眾口難調。如果您發(fā)現(xiàn)某些最佳實踐或者話題并沒有涵蓋在本文檔中，請告知我們一站式示例代碼庫項目組 ，以不斷充實改善本文檔。鳴謝本文檔的每一章節(jié)都應該感謝Dan Ruder 微軟Principal Escalation Engineer 。 同時，如果沒有如下一站式代碼示例庫項目的關鍵成員的辛勤付出，本文檔必定不會具有現(xiàn)在的技術深度以及完整度，我在這里要感謝他們：Hongye Sun Jie Wang Ji Zhou Michael Sun Kira Qian Linda LiuAllen Chen YiLun Luo Steven Cheng WenJun Zhang本文檔部分章節(jié)參考自一些微軟產品組的編程規(guī)范。目錄1 概覽 1 原則和主旨 1 術語 22 通用編程規(guī)范 3 明確和一致 3 格式和風格 3 庫的使用 5 全局變量 5 變量的聲明和初始化 6 函數(shù)的聲明和調用 7 語句 8 枚舉 9 空格 14 大括號 15 注釋 17 代碼塊 263 C++ 編程規(guī)范 27 編譯器選項 27 文件和結構 29 命名規(guī)范 30 指針 34 常量 34 類型轉換 35 Sizeof 36 字符串 37 數(shù)組 38 宏 39 函數(shù) 40 結構體 43 類 44 COM 50 動態(tài)分配 51 錯誤和異常 52 資源清理 55 控制流 584 .NET 編碼規(guī)范 61 類庫開發(fā)設計規(guī)范 61 文件和結構 61 程序集屬性 61 命名規(guī)范 61 常量 65 字符串 65 數(shù)組和集合 67 結構體 69 類 70 命名空間 74 錯誤和異常 74 資源清理 77 交互操作 90Page 471 概覽 本文檔為一站式示例代碼庫項目組所使用的C++ 以及 .NET 編碼規(guī)范 。示例代碼的相關部分應當易于重用。4. 流行性 – 代碼示例應當展示現(xiàn)行的編程實踐，例如使用 Unicode，錯誤處理，防御式編程以及可移植性。 術語在整個文檔中，會有一些對于標準和實踐的推薦和建議。 一定不要...不允許應用該規(guī)范或實踐。該規(guī)范可用于編程風格，但不總是有益的。 格式和風格253。為了提高易讀性，將代碼長度設置為78列。 一定請 盡量少用全局變量。254。 一定不要 在同一行中聲明多個變量 。 函數(shù)的聲明和調用 函數(shù)或方法的名稱，返回值，參數(shù)列表可以有多種形式。函數(shù)或方法調用時的參數(shù)列表同樣需按照這一格式。 代碼語句253。 一定請 將代表某些值集合的強類型參數(shù)，屬性和返回值聲明為枚舉類型。}253。第二，它存在版本的問題。254。 您不應該 在標志枚舉中使用0值，除非它代表 “所有標志被清除了” ，并被恰當?shù)拿麨轭愃啤癗one”的名字。 比如，您可以在變量聲明和代碼之間有一行空行。 空格空格通過降低代碼密度以增加可讀性 。 // No spaces after masCreateFoo（ myChar, 0, 1 ）。}Bad （in AllInOne Code Framework samples）:// C++ / C sample:if （x 5） { y = 0。一定不要 讓注釋僅僅是重復代碼。Good:// Intialize the ponents on the Windows Form.InitializeComponent（）。其之前和之后都有一個空行。 // The accuracy of the example}。 // Get the next wrinkle if （pWrinkleIsNew（） amp。amp。 您應該為 每一個重要的類或結構體作注釋。 C 和 使用 .NET 描述性 XML 文檔化 注釋。 }*//// summary/// The function checks whether the primary access token of the process /// belongs to user account that is a member of the local Administrators /// group, even if it currently is not elevated./// /summary/// param name=tokenThe handle to an access token/param/// returns/// Returns true if the primary access token of the process belongs to /// user account that is a member of the local Administrators group. /// Returns false if the token does not./// /returns/// exception cref=/// When any native Windows API call fails, the function throws a /// Win32Exception with the last error code./// /exception任何調用失敗會帶來副作用的方法或函數(shù)，都需要清楚地在注釋中交代那