CA1825:長さ 0 の配列割り当てを回避します

プロパティ	値
ルール ID	CA1825
Title	長さ 0 の配列割り当てを回避します
[カテゴリ]	パフォーマンス
修正が中断ありか中断なしか	なし
.NET 8 では既定で有効	提案として

原因

要素のない空の Array が割り当てられています。

規則の説明

長さ 0 の配列を初期化すると、不要なメモリ割り当てが発生します。 代わりに、Array.Empty メソッドを呼び出して、静的に割り当てられた空の配列インスタンスを使用してください。 メモリ割り当ては、このメソッドのすべての呼び出しで共有されます。

違反の修正方法

違反を修正するには、長さ 0 の配列の割り当てを Array.Empty の呼び出しに置き換えます。 たとえば、次の 2 つのコード スニペットは、規則違反とその修正方法を示しています。

class C
{
    public void M1()
    {
        // Violates rule CA1825.
        var a = new int[0];
    }
}

class C
{
    public void M1()
    {
        // Resolves rule CA1825 violation.
        var a = System.Array.Empty<int>();
    }
}

ヒント

Visual Studio では、この規則に対するコード修正を使用できます。 これを使用するには、配列割り当てにカーソルを置き、Ctrl+. (ピリオド) を押します。 表示されるオプションの一覧から、[Array.Empty を使用する] を選択します。

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

メモリの割り当てを追加する必要がない場合は、この規則違反を抑制しても問題ありません。

Note

次のすべてに該当する場合、このルールから擬陽性の警告が表示される場合があります。

• Visual Studio 2022 バージョン 17.5 以降を NET SDK の古いバージョン (.NET 6 以前) で使用している場合。
• .NET 6 SDK またはそれ以前のバージョンのアナライザー パッケージ (Microsoft.CodeAnalysis.FxCopAnalyzers など) のアナライザーを使用している。
• 属性引数として長さ 0 の配列を使用していますが、最も一般的には params パラメーターとして使用されます。

この擬陽性は、C# コンパイラの破壊的変更 が原因です。 擬陽性警告の修正プログラムを含む新しいアナライザーの使用を検討してください。 Microsoft.CodeAnalysis.NetAnalyzers バージョン 7.0.0-preview1.22464.1 以降にアップグレードするか、.NET 7 SDK のアナライザーを使用します。

警告を抑制する

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

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

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

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

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

関連規則

• CA1814:複数次元の配列ではなくジャグ配列を使用します

関連項目

• パフォーマンス ルール