列挙体パラメーターまたはブール (Boolean) 型パラメーターの選択

パラメーターの型を列挙体にするか、Boolean 値にするかを判断するには、次のガイドラインに従います。

メンバーが複数のブール型のパラメーターを持つ場合は、列挙体を使用します。

列挙体を使用すると、メンバーシグネチャのわかりやすさが大幅に向上します。たとえば、次のようなメソッド呼び出しがあるとします。

Type.GetType("Contoso.Controls.Array", True, False)

Type.GetType("Contoso.Controls.Array", true, false);

Type::GetType("Contoso.Controls.Array", true, false);

このような呼び出しは、ドキュメントを確認するか、コードコメントを追加しない限り、理解することが非常に困難です。次のコード例に示すように、複数のブール値の代わりに列挙値を使用すると、呼び出しが大幅にわかりやすくなります。

BetterType.GetType("Contoso.Controls.Array", _
    ErrorOptions.ThrowOnError, _
    CasingOptions.CaseInsensitive)

BetterType.GetType("Contoso.Controls.Array", 
    ErrorOptions.ThrowOnError, 
    CasingOptions.CaseInsensitive);

BetterType::GetType("Contoso.Controls.Array",
ErrorOptions::ThrowOnError,
CasingOptions::CaseInsensitive);

3 つ以上の値を使用する必要がないことが確実な場合を除いて、ブール型を使用しないようにします。

列挙体を使用した場合、新しいバージョンで値を追加できます。ただし、列挙体に値を追加すると、互換性の問題が発生する可能性があります。詳細については、「列挙体への値の追加」を参照してください。

設計ガイドラインの詳細についてを参照してください、「フレームワークの設計ガイドライン。規則、慣用句、および再利用可能なパターン。ネットライブラリ」本クシシュトフ Cwalina、ブラッドエイブラムス、アスキー、2005 年発表しました。

参照