CA2264: No pasar un valor no anulable a 'ArgumentNullException.ThrowIfNull'

Propiedad	Valor
Identificador de la regla	CA2264
Título	No pase un valor no nullable a ArgumentNullException.ThrowIfNull
Categoría	Uso
La corrección interrumpe o no interrumpe	Sin interrupción
Habilitado de forma predeterminada en .NET 10	Como advertencia
Idiomas aplicables	C# y Visual Basic

Causa

Un valor que se sabe que nunca es NULL se pasa a ArgumentNullException.ThrowIfNull().

Descripción de la regla

ArgumentNullException.ThrowIfNull produce cuando el argumento pasado es null. Ciertas construcciones, como estructuras no anulables (excepto para Nullable<T>), los parámetros de tipo conocidos como structs no anulables, expresiones 'nameof()' y las expresiones 'new' se conocen por nunca ser NULL, por lo que ArgumentNullException.ThrowIfNull nunca se producirá. Por lo tanto, la llamada ArgumentNullException.ThrowIfNull no es necesaria.

En el caso de una struct, dado que ArgumentNullException.ThrowIfNull acepta un object?, la struct se somete a boxing, lo que causa una pérdida de rendimiento adicional.

Cómo corregir infracciones

Quite la ArgumentNullException.ThrowIfNull invocación.

Ejemplo

El siguiente fragmento de código muestra una infracción de CA2264:

static void Print(int value)
{
    ArgumentNullException.ThrowIfNull(value);
    Console.WriteLine(value);
}

El siguiente fragmento de código corrige la infracción:

static void Print(int value)
{
    Console.WriteLine(value.Value);
}

Cuándo suprimir las advertencias

Siempre es seguro suprimir esta advertencia.

Supresión de una advertencia

Si solo quiere suprimir una única infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y volver a habilitar la regla.

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

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none del archivo de configuración.

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

Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.

Consulte también

• CA1871: No pase una estructura nullable a 'ArgumentNullException.ThrowIfNull