抽象クラスの命名規則

Microsoftが推し進めたガイドラインでは、抽象クラスに「Base」サフィックスを追加して、抽象クラスであるという事実を未然に防ぐことでした。したがって、のようなクラスがありますSystem.Web.Hosting.VirtualFileBase。System.Configuration.ConfigurationValidatorBase、System.Windows.Forms.ButtonBase、、そして、もちろんSystem.Collections.CollectionBase。

しかし、最近、フレームワークの多くの抽象クラスがこの規則に従っていないように見えました。たとえば、次のクラスはすべて抽象ですが、この規則に従っていません。

• System.DirectoryServices.ActiveDirectory.DirectoryServer

• System.Configuration.ConfigurationElement

• System.Drawing.Brush

• System.Windows.Forms.CommonDialog

そして、それは私が数秒でドラムアップすることができるものです。それで、私は狂っていないことを確認するために、公式文書が何を言わなければならないか調べました。クラスライブラリを開発するための設計ガイドラインで、 MSDN のクラス、構造体、およびインターフェイスの名前を見つけました。奇妙なことに、抽象クラスの名前の最後に「Base」を追加するためのガイドラインについての言及はありません。また、ガイドラインはフレームワークのバージョン1.1では利用できなくなりました。

それで、私はそれを失っていますか？このガイドラインは存在しましたか？それは何の言葉もなく捨てられたのですか？過去2年間、自分で長いクラス名を1つも作成していませんか。

誰かがここで骨を投げます。

更新 私は狂っていません。ガイドラインは存在した。Krzysztof Cwalinaは2005年にそれについて不満を述べています。

ではFrameworkの設計ガイドライン P 174本の状態：

クラスがパブリックAPIでの使用を目的としている場合は、「Base」サフィックスを使用して基本クラスに名前を付けないでください。

また：http : //blogs.msdn.com/kcwalina/archive/2005/12/16/BaseSuffix.aspx

また、抽象クラスに使用される静的メンバーがいくつかある場合、「ベース」は醜くなります。

そのようなガイドラインは覚えていません。わかりやすい名前を付けるべきだと思います。抽象クラスは、一部のクラスに（ツールとして）共通の機能を提供するためだけに設計されていることがあります。ただし、場合によっては、それをそれ自体では完成しない多態性階層のベースとして使用する必要があります。そのような場合は、通常のクラスのように名前を付けることをお勧めします。

ご覧のとおり、ButtonBaseをパラメータとして受け入れるメソッドはおそらく宣言しません。サブクラスに最小限の機能を提供するように設計されています。ただし、をConfigurationElement異なる形式のエンティティとして扱うこともできますが、それ自体では完全ではありません（したがって、それは抽象です）

特に、具体的な実装を作成するために拡張するために具象クラスと抽象クラスの両方を提供する場合は特に、Baseが依然として必要です。
例：ControllerおよびControllerBase（実際にはControllerも抽象的ですが、ControllerBaseよりも大幅に多くの機能を提供します）

インターフェイスに対してプログラミングする場合、ベースサフィックスは醜いので、抽象クラスが主にインターフェイスのように使用されている場合、それを使用しないというMicrosoftのガイドラインが当てはまると思います。おそらく、それらはパブリックAPIで何を意味するのでしょう。

ポイントは、Baseサフィックスを使用するより良い代替手段がない場合があるということです。

ベースサフィックスを避ける傾向を理解していますが、いくつかのサフィックスの必要性も理解しています。現在、この記事のコメントでは、「タイプ」をサフィックスとして使用しないことの2番目の選択肢として使用することを提案しています。私はこれは混乱を招くと思いますが、「そのようなコミットメントのない言葉は、それがコミットメントのないクラスであることを示す傾向がある」という考えは私に付きました。

別の方法として：オブジェクトを「指定された人種または家族の、またはそれに属している」と表す接尾辞として「種類」を使用することをお勧めします（ウィクショナリー：-kind）。

例：DataProviderとReflectiveDataProvider両方DataProviderKind

たとえば「canis lupus」が「Canoidea」ファミリーに属している生物学に触発され、これは非常に大まかに「犬っぽい」に変換されます。

Microsoftは次のように述べています。

https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/names-of-classes-structs-and-interfaces

"✓派生クラスの名前を基本クラスの名前で終了することを検討してください。これは非常に読みやすく、関係を明確に説明します。コード内のこの例の一部は、例外の一種であるArgumentOutOfRangeExceptionと、一種の属性です。ただし、このガイドラインを適用する際は、合理的な判断を行うことが重要です。たとえば、ボタンクラスは一種のコントロールイベントですが、名前にコントロールは表示されません。」

一般的に言って、これは名前に「ベース」を使用することを暗黙的に除外します。