CA1870: キャッシュされた 'SearchValues' インスタンスを使用する

プロパティ	値
ルール ID	CA1870
Title	キャッシュされた 'SearchValues' インスタンスを使用する
[カテゴリ]	パフォーマンス
修正が中断ありか中断なしか	なし
.NET 9 では既定で有効	提案として

原因

IndexOfAny または ContainsAny メソッドは、多くの定数値を使用して呼び出される方法では、代わりに SearchValues を使用したほうが有利な場合があります。

このルールでは、最適な実装が既に使用されているため、最大 5 つの値を使用する呼び出しにフラグを設定しません。

規則の説明

キャッシュされた SearchValues<T> インスタンスを使用すると、値を IndexOfAny または ContainsAny に直接渡すよりも効率的です。

違反の修正方法

static readonly フィールドに SearchValues<T> インスタンスを作成してキャッシュし、代わりにそのインスタンスを IndexOfAny または ContainsAny 呼び出しに渡します。

この変換を実行するコード修正ツールを使用できます。

例

次のコード スニペットは、CA1870 の 2 つの違反を示しています:

static readonly char[] MyValues = new[] { 'a', 'b', 'c', 'x', 'y', 'z' };

static int IndexOfMyValues(ReadOnlySpan<char> text)
{
    return text.IndexOfAny(MyValues);
}

static bool ContainsOnlyMyValues(ReadOnlySpan<char> text)
{
    return !text.ContainsAnyExcept("abcxyz");
}

次のコード スニペットでは、これらの違反を修正しています。

private static readonly SearchValues<char> s_myValues = SearchValues.Create("abcxyz");

static int IndexOfMyValues(ReadOnlySpan<char> text)
{
    return text.IndexOfAny(s_myValues);
}

static bool ContainsOnlyMyValues(ReadOnlySpan<char> text)
{
    return !text.ContainsAnyExcept(s_myValues);
}

同じ値のセットで IndexOfAny を複数回呼び出す場合は、 s_myValues 再利用する必要があります。

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

パフォーマンスが問題でない場合は、この警告を抑制しても問題ありません。

警告を抑制する

単一の違反を抑制するだけの場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則をもう一度有効にします。

#pragma warning disable CA1870
// The code that's violating the rule is on this line.
#pragma warning restore CA1870

ファイル、フォルダー、またはプロジェクトの規則を無効にするには、構成ファイルでその重要度を none に設定します。

[*.{cs,vb}]
dotnet_diagnostic.CA1870.severity = none

詳細については、「コード分析の警告を抑制する方法」を参照してください。