命名參數

注意

此內容是由 Pearson Education, Inc. 授權轉載自架構設計指導方針:可重複使用 .NET 程式庫的慣例、慣用語和模式,第 2 版。 該版於 2008 年出版,該書自那以後已於第三版進行了全面修訂。 此頁面上的某些資訊可能已過期。

除了可讀性的明顯原因之外,請務必遵循參數名稱的指導方針,因為在視覺化設計工具提供 Intellisense 和類別流覽功能時,文件和設計工具中會顯示參數。

✔️ 請在參數名稱中使用 camelCasing。

✔️ 請使用描述性參數名稱。

✔️ 請考慮根據參數的意義來使用名稱,而不是參數的類型。

命名運算子多載參數

✔️ 如果對參數沒有意義,請使用 leftright 作為二元運算子多載參數名稱。

✔️ 如果對參數沒有意義,請使用 value 做為一元運算子多載參數名稱。

✔️ 如果這樣做會增加顯著值,請考慮對於運算子多載參數有意義的名稱。

❌ 請勿使用縮寫或數值索引做為運算子多載參數名稱。

Portions © 2005, 2009 Microsoft Corporation. 著作權所有,並保留一切權利。

獲 Pearson Education, Inc. 的授權再版,從 Krzysztof Cwalina 和 Brad Abrams 撰寫,並在 2008 年 10 月 22 日由 Addison-Wesley Professional 出版,作為 Microsoft Windows Development Series 一部份的 Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition 節錄。

另請參閱