CA1814:建議使用不規則陣列取代多維陣列

屬性	值
規則識別碼	CA1814
標題	建議使用不規則陣列取代多維陣列
類別	效能
修正程式是中斷或非中斷	中斷
預設在 .NET 8 中啟用	No

原因

成員宣告為多維度陣列，這可能會導致某些數據集浪費空間。

檔案描述

在多維度陣列中，每個維度中的每個元素都有與該維度中其他元素相同的固定大小。 在不規則陣列中，這是陣列的陣列，每個內部數位的大小都可以不同。 只要使用指定數位所需的空間，就不會浪費任何空間。 此規則 CA1814 建議切換至鋸齒狀陣列以節省記憶體。

如何修正違規

若要修正此規則的違規問題，請將多維度陣列變更為不規則的陣列。

隱藏警告的時機

如果多維度陣列不會浪費空間，則隱藏此規則的警告是可以的。

隱藏警告

如果您只想要隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。

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

若要停用檔案、資料夾或項目的規則，請在組態檔中將其嚴重性設定為 。none

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

如需詳細資訊，請參閱 如何隱藏程式代碼分析警告。

範例

下列範例顯示鋸齒狀和多維度陣列的宣告。

Imports System

Public Class ArrayHolder
    Private jaggedArray As Integer()() =  {New Integer() {1, 2, 3, 4}, _
                                           New Integer() {5, 6, 7}, _
                                           New Integer() {8}, _
                                           New Integer() {9}}
    
    Private multiDimArray As Integer(,) =  {{1, 2, 3, 4}, _
                                            {5, 6, 7, 0}, _
                                            {8, 0, 0, 0}, _
                                            {9, 0, 0, 0}}
End Class

public class ArrayHolder
{
    int[][] jaggedArray = { new int[] {1,2,3,4},
                            new int[] {5,6,7},
                            new int[] {8},
                            new int[] {9}
                          };

    int[,] multiDimArray = {{1,2,3,4},
                             {5,6,7,0},
                             {8,0,0,0},
                             {9,0,0,0}
                            };
}