CA1814: Voorkeur aan gelabelde matrices boven multidimensionaal

Eigenschappen	Weergegeven als
Regel-id	CA1814
Titel	Voorkeur aan gelabelde matrices boven multidimensionaal
Categorie	Prestaties
Oplossing is brekend of niet-brekend	Breken
Standaard ingeschakeld in .NET 9	Nee

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.

Schendingen oplossen

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 Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Opmerking

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