CA1814: Voorkeur aan ongelijke arrays boven multidimensionale arrays

Eigenschap	Waarde
Regel-id	CA1814
Titel	Geeft de voorkeur aan getrapte arrays boven multidimensionale arrays.
Categorie	Prestaties
Fix kan brekend of niet-brekend zijn	Onderbreking
Standaard ingeschakeld in .NET 10	Nee
Toepasselijke talen	C# en Visual Basic

Oorzaak

Een lid wordt gedeclareerd als een multidimensionale matrix, wat kan leiden tot verspilde ruimte voor sommige gegevenssets.

Beschrijving van regel

In een multidimensionale matrix heeft elk element in elke dimensie dezelfde, vaste grootte als de andere elementen in die dimensie. In een gelabelde matrix, een matrix met matrices, kan elke binnenste matrix een andere grootte hebben. Door alleen de ruimte te gebruiken die nodig is voor een bepaalde matrix, wordt er geen ruimte verspild. Deze regel, CA1814, raadt u aan over te schakelen naar een onregelmatige matrix om geheugen te besparen.

Hoe schendingen op te lossen

Als u een schending van deze regel wilt oplossen, wijzigt u de multidimensionale matrix in een onregelmatige matrix.

Wanneer waarschuwingen onderdrukken

Het is geen probleem om een waarschuwing van deze regel te onderdrukken als de multidimensionale matrix geen ruimte verspilt.

Een waarschuwing onderdrukken

Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.

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

Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.

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

Zie voor meer informatie Hoe codeanalysewaarschuwingen te onderdrukken.

Voorbeeld

In het volgende voorbeeld ziet u declaraties voor onregelmatige en multidimensionale matrices.

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}
                            };
}