CA1510:Uso del asistente de inicio ArgumentNullException
| Propiedad | Value |
|---|---|
| Identificador de la regla | CA1510 |
| Título | Uso del asistente de inicio de ArgumentNullException |
| Categoría | Capacidad de mantenimiento |
| La corrección es problemática o no problemática | No problemática |
| Habilitado de forma predeterminada en .NET 8 | Como sugerencia |
Causa
El código comprueba si un argumento está null y, a continuación, produce condicionalmente un ArgumentNullException.
Descripción de la regla
Las comprobaciones de argumentos tienen un impacto considerable en el tamaño del código y suelen dominar el código para funciones pequeñas y establecedores de propiedades. Estas comprobaciones impiden la inserción y provocan una contaminación sustancial de la caché de instrucciones. Los métodos de asistentes de inicio como ArgumentNullException.ThrowIfNull son más sencillos y eficaces que bloques if que construyen una nueva instancia de excepción.
Ejemplo
El siguiente fragmento de código muestra una infracción de CA1510:
void M(string arg)
{
if (arg is null)
throw new ArgumentNullException(nameof(arg));
}
En el siguiente fragmento de código se muestran la corrección:
void M(string arg)
{
ArgumentNullException.ThrowIfNull(arg);
}
Cómo corregir infracciones
Reemplace el bloque if que produce la excepción por una llamada a ArgumentNullException.ThrowIfNull. O bien, en Visual Studio, use el menú de bombilla para corregir el código automáticamente.
Cuándo suprimir las advertencias
Es seguro suprimir una infracción de esta regla si no le preocupa el mantenimiento del código. También es preciso suprimir las infracciones que se identifican como falsos positivos.
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 CA1510
// The code that's violating the rule is on this line.
#pragma warning restore CA1510
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.CA1510.severity = none
Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.
