CA1875: 'Regex.Count' を使用する

プロパティ	価値
ルール識別子	CA1875
タイトル	Regex.Count を使用する
カテゴリ	パフォーマンス
修正が破壊的であるか非破壊的であるか	Non-breaking
.NET 10 で既定で有効	提案として

原因

Regex.MatchesからのMatchCollectionのCount プロパティは、一致の数を取得するために使用されます。

ルールの説明

Regex.Count は、 Regex.Matches(...).Countよりもシンプルで高速です。 Count()メソッドは、完全なMatchCollectionを具体化することなく、一致をカウントするために最適化されています。 Matches()を呼び出してから.Countにアクセスすると、パフォーマンスに影響する可能性のある不要な作業が行われます。

違反を修正する方法

Regex.Matches(...).Countの呼び出しをRegex.Count(...)に置き換えます。

この変換を自動的に実行する コード修正 プログラムを使用できます。

Example

次のコード スニペットは、CA1875 の違反を示しています。

using System.Text.RegularExpressions;

class Example
{
    public int CountWords(string text)
    {
        // Violation
        return Regex.Matches(text, @"\b\w+\b").Count;
    }
}

Imports System.Text.RegularExpressions

Class Example
    Public Function CountWords(text As String) As Integer
        ' Violation
        Return Regex.Matches(text, "\b\w+\b").Count
    End Function
End Class

次のコード スニペットは、違反を修正します。

using System.Text.RegularExpressions;

class Example
{
    public int CountWords(string text)
    {
        // Fixed
        return Regex.Count(text, @"\b\w+\b");
    }
}

Imports System.Text.RegularExpressions

Class Example
    Public Function CountWords(text As String) As Integer
        ' Fixed
        Return Regex.Count(text, "\b\w+\b")
    End Function
End Class

警告を抑制するタイミング

パフォーマンスに問題がない場合、または (.NET 7 より前の) Regex.Count を含まない .NET のバージョンを対象としている場合は、この規則からの警告を抑制しても安全です。

警告を抑制する

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

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

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

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

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

こちらも参照ください

• パフォーマンス ルール
• Regex.Count
• Regex.Matches