CA1825: Evitare allocazioni di matrici di lunghezza zero
Proprietà | valore |
---|---|
ID regola | CA1825 |
Title | Evitare allocazioni di matrici di lunghezza zero |
Categoria | Prestazioni |
La correzione causa un'interruzione o meno | Non causa un'interruzione |
Abilitato per impostazione predefinita in .NET 9 | 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.