CA1701: リソース文字列の複合語は、大文字と小文字を正しく区別しなければなりません
Item | [値] |
---|---|
規則 ID | CA1701 |
カテゴリ | Microsoft.Naming |
互換性に影響する変更点 | なし |
原因
リソース文字列に、大文字と小文字が正しく区別されていないように思われる複合語が含まれています。
Note
このルールは非推奨とされました。 詳細については、「非推奨の規則」を参照してください。
規則の説明
リソース文字列内の語は、大文字と小文字の指定に基づいてトークンに分割されます。 Microsoft スペル チェック ライブラリは、隣接する 2 つのトークンの組み合わせを個別にチェックします。 それらが認識されると、その語はこの規則への違反となります。 違反の原因となる複合語の例としては、"CheckSum" や "MultiPart" があります。これは、それぞれ "Checksum" と "Multipart" として大文字と小文字を指定する必要があります。 以前の一般的な使用法が原因で、いくつかの例外が規則に組み込まれています。"Toolbar" や "Filename" などのいくつかの単一の単語には、2 つの別個の単語として大文字と小文字を指定する必要があるとしてフラグが設定されています。 この例では、"ToolBar" と "FileName" にフラグが設定されています。
名前付け規則では、共通言語ランタイムをターゲットとするライブラリの統一的な名前の付け方が規定されています。 これにより、新しいソフトウェア ライブラリを習得するまでの時間を短縮でき、マネージド コード開発の専門家によってライブラリが開発されたという信頼を顧客に与えることができます。
違反の修正方法
大文字と小文字が正しくなるように単語を変更します。
辞書の言語を変更する
既定では、英語 (en) バージョンのスペル チェックが使用されます。 スペル チェックの言語を変更する場合は、次のいずれかの属性を AssemblyInfo.cs または AssemblyInfo.vb ファイルに追加します。
- リソースがサテライト アセンブリにある場合は、AssemblyCultureAttribute を使用してカルチャを指定します。
- リソースがコードと同じアセンブリにある場合は、NeutralResourcesLanguageAttribute を使用して、アセンブリの "ニュートラル カルチャ" を指定します。
重要
カルチャを英語ベースのカルチャ以外に設定した場合、このコード分析規則は警告なしで無効になります。
どのようなときに警告を抑制するか
複合語の両方の部分がスペル辞書によって認識されおり、2 つの単語を使用することを目的としている場合は、この規則による警告を抑制しても問題ありません。
また、スペル チェック用のカスタム辞書に複合語を追加することもできます。 カスタム辞書内の単語は、違反を発生させません。 詳細については、「方法 : コード分析辞書をカスタマイズする」を参照してください。
関連規則
- CA1702: 複合語では、大文字と小文字が正しく区別されなければなりません
- CA1709: 識別子では、大文字と小文字が正しく区別されなければなりません
- CA1708:識別子は、大文字と小文字の区別以外にも相違していなければなりません
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示