CA1825: Evitare allocazioni di matrici di lunghezza zero

Proprietà	valore
ID regola	CA1825
Title	Evitare allocazioni di matrici di lunghezza zero
Categoria	Prestazioni
Correzione che causa un'interruzione o un'interruzione	Nessuna interruzione
Abilitato per impostazione predefinita in .NET 8	Come suggerimento

Causa

Viene allocato un oggetto vuoto Array senza elementi.

Descrizione regola

L'inizializzazione di una matrice di lunghezza zero comporta un'allocazione di memoria non necessaria. Usare invece l'istanza di matrice vuota allocata in modo statico chiamando il Array.Empty metodo . L'allocazione di memoria viene condivisa tra tutte le chiamate di questo metodo.

Come correggere le violazioni

Per correggere una violazione, sostituire l'allocazione di matrici di lunghezza zero con una chiamata a Array.Empty. Ad esempio, i due frammenti di codice seguenti mostrano una violazione della regola e come risolverli:

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

Suggerimento

Una correzione del codice è disponibile per questa regola in Visual Studio. Per usarlo, posizionare il cursore sull'allocazione della matrice e premere CTRL+. (punto). Scegliere Usa Array.Empty nell'elenco delle opzioni presentate.

Quando eliminare gli avvisi

Se non si è interessati all'allocazione di memoria aggiuntiva, è possibile eliminare una violazione di questa regola.

Nota

Se si applicano tutti gli avvisi seguenti, è possibile che vengano visualizzati avvisi falsi positivi da questa regola:

• Si usa Visual Studio 2022 versione 17.5 o successiva con una versione precedente di .NET SDK, ovvero .NET 6 o versioni precedenti.
• Si usano gli analizzatori di .NET 6 SDK o una versione precedente dei pacchetti analizzatori, ad esempio Microsoft.CodeAnalysis.FxCopAnalyzers.
• Si usa una matrice di lunghezza zero come argomento dell'attributo, in genere come params parametro.

I falsi positivi sono dovuti a una modifica che causa un'interruzione nel compilatore C#. Prendere in considerazione l'uso di un analizzatore più recente che contiene la correzione per gli avvisi falsi positivi. Eseguire l'aggiornamento a Microsoft.CodeAnalysis.NetAnalyzers versione 7.0.0-preview1.22464.1 o successiva o usare gli analizzatori di .NET 7 SDK.

Eliminare un avviso

Se si vuole eliminare una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.

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

Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità none su nel file di configurazione.

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

Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.

Regole correlate

• CA1814: Preferire matrici di matrici rispetto a matrici multidimensionali

Vedi anche

• Regole di prestazioni