更新 : 2007 年 11 月
適切なパラメータ名を選択すると、ライブラリの使いやすさが大幅に向上します。適切なパラメータ名とは、パラメータの影響を受けるデータまたは機能を示す名前です。
パラメータ名には説明的な名前を使用します。
ほとんどのシナリオで、パラメータ名と型を見ただけでパラメータの使用法が判断できるような名前にする必要があります。
パラメータの型に基づいた名前ではなく、パラメータの意味に基づいた名前を使用してください。
通常、パラメータの型は、開発ツールやドキュメントに表示されます。パラメータの使用法や意味を説明する名前を選択することによって、開発者が、タスクに適したメンバを識別し、適切なデータをメンバに渡すうえで有益な情報を提供できます。
Portions Copyright 2005 Microsoft Corporation.All rights reserved.
Portions Copyright Addison-Wesley Corporation.All rights reserved.
デザイン ガイドラインの詳細については、2005 年に Addison-Wesley から出版されている Krzysztof Cwalina、Brad Abrams 共著の『Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries』を参照してください。