次の方法で共有

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

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

原因

要素のない空の 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 を使用する] を選択します。

CA1825 (空の配列を使用する) のコード修正

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

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

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

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

関連項目