パラメーターに名前を付ける
Note
このコンテンツは、Pearson Education, Inc. の許可を得て、『Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition (フレームワーク設計ガイドライン: 再利用可能な .NET ライブラリの規約、表現形式、およびパターン、第 2 版)』から転載されています。 この版は 2008 年に出版され、その後、この本は第 3 版で全面的に改訂されました。 このページの情報の一部は古くなっている可能性があります。
読みやすさという明らかな理由の他に、パラメーター名のガイドラインに従うことが重要です。それは、ビジュアル デザイン ツールが Intellisense とクラス閲覧機能を備えているとき、ドキュメントとデザイナーにパラメーターが表示されるからです。
✔️ パラメーター名にはキャメル ケースを使用します。
✔️ 説明的なパラメーター名を使用します。
✔️ パラメーターの型ではなく意味に基づく名前の使用を検討してください。
演算子オーバーロード パラメーターに名前を付ける
✔️ パラメーターに意味がない場合、二項演算子オーバーロード パラメーターの名前には left と right を使用します。
✔️ パラメーターに意味がない場合、単項演算子オーバーロード パラメーターの名前には value を使用します。
✔️ 演算子のオーバーロード パラメーターに意味のある名前をつけることで、大きな価値がある場合はこれを検討してください。
❌ 演算子オーバーロード パラメーター名には省略形や数値インデックスは使用しないでください。
Portions © 2005, 2009 Microsoft Corporation. All rights reserved.
2008 年 10 月 22 日に Microsoft Windows Development シリーズの一部として、Addison-Wesley Professional によって発行された、Krzysztof Cwalina および Brad Abrams による「Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition」 (フレームワーク デザイン ガイドライン: 再利用可能な .NET ライブラリの規則、用法、パターン、第 2 版) から Pearson Education, Inc. の許可を得て再印刷されています。