CA1702: 複合語では、大文字と小文字が正しく区別されなければなりません

Item [値]
規則 ID CA1702
カテゴリ Microsoft.Naming
互換性に影響する変更点 中断あり - アセンブリで発生した場合。

中断なし - 型パラメーターで発生した場合。

原因

識別子の名前に複数の語が含まれており、大文字と小文字が正しく使い分けられていない複合語が 1 つ以上あります。

Note

このルールは非推奨とされました。 詳細については、「非推奨の規則」を参照してください。

規則の説明

識別子の名前は、大文字と小文字の指定に基づく単語に分割されます。 Microsoft スペル チェック ライブラリでは、隣接する 2 つの単語の組み合わせを個別にチェックします。 これが認識されると、その識別子はこの規則への違反となります。 違反の原因となる複合語の例としては、"CheckSum" や "MultiPart" があります。これは、それぞれ "Checksum" と "Multipart" として大文字と小文字を指定する必要があります。 以前の一般的な使用法が原因で、いくつかの例外が規則に組み込まれています。"Toolbar" や "Filename" などのいくつかの単一の単語には、2 つの別個の単語 (この場合は、"ToolBar" と "FileName") として大文字と小文字を指定する必要があるとしてフラグが設定されています。

名前付け規則では、共通言語ランタイムをターゲットとするライブラリの統一的な名前の付け方が規定されています。 これにより、新しいソフトウェア ライブラリを習得するまでの時間を短縮でき、マネージド コード開発の専門家によってライブラリが開発されたという信頼を顧客に与えることができます。

違反の修正方法

大文字と小文字が正しくなるように名前を変更します。

言語

スペル チェックでは現在、英語ベースのカルチャ辞書に対してのみチェックが実行されます。 プロジェクト ファイル内のプロジェクトのカルチャを変更するには、CodeAnalysisCulture 要素を追加します。

たとえば次のような点です。

<Project ...>
  <PropertyGroup>
    <CodeAnalysisCulture>en-AU</CodeAnalysisCulture>

重要

カルチャを英語ベースのカルチャ以外に設定した場合、このコード分析規則は警告なしで無効になります。

どのようなときに警告を抑制するか

複合語の両方の部分がスペル辞書によって認識されており、2 つの単語を使用することを目的としている場合は、この規則による警告を抑制しても問題ありません。

関連項目