CA2264: Non passare un valore non nullable a 'ArgumentNullException.ThrowIfNull'
Proprietà | valore |
---|---|
ID regola | CA2264 |
Title | Non passare un valore non nullable a ArgumentNullException.ThrowIfNull |
Categoria | Utilizzo |
La correzione causa un'interruzione o meno | Non causa un'interruzione |
Abilitato per impostazione predefinita in .NET 9 | Come avviso |
Causa
Quando un valore noto per non essere mai null viene passato a ArgumentNullException.ThrowIfNull()
, non viene mai generata un'eccezione, rendendo l'istruzione no-op.
Descrizione regola
ArgumentNullException.ThrowIfNull
genera quando l'argomento passato è null
. Alcuni costrutti come struct non nullable (ad eccezione Nullable<T>di ), i parametri di tipo noti come struct non nullable, le espressioni 'nameof()' e le espressioni 'new' non sono mai null, quindi ArgumentNullException.ThrowIfNull
non generano mai un'eccezione.
Nel caso di uno struct, poiché ArgumentNullException.ThrowIfNull
accetta un object?
oggetto , lo struct viene sottoposto a boxing, causando una riduzione delle prestazioni aggiuntiva.
Come correggere le violazioni
Rimuovere la ArgumentNullException.ThrowIfNull
chiamata.
Esempio
Il frammento di codice seguente mostra una violazione di CA2264:
static void Print(int value)
{
ArgumentNullException.ThrowIfNull(value);
Console.WriteLine(value);
}
Il frammento di codice seguente corregge la violazione:
static void Print(int value)
{
Console.WriteLine(value.Value);
}
Quando eliminare gli avvisi
È sempre sicuro eliminare questo avviso.
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 CA2264
// The code that's violating the rule is on this line.
#pragma warning restore CA2264
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.CA2264.severity = none
Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.