CA1510: Usar o auxiliar de lançamento ArgumentNullException

Artigo
11/12/2024

Property	valor
ID da regra	CA1510
Título	Usar o auxiliar de lançamento ArgumentNullException
Categoria	Manutenibilidade
A correção está quebrando ou não quebrando	Não-quebrando
Habilitado por padrão no .NET 9	Como sugestão

Motivo

O código verifica se um argumento é null e, em seguida, condicionalmente lança um ArgumentNullExceptionarquivo .

Descrição da regra

As verificações de argumento têm um impacto substancial no tamanho do código e geralmente dominam o código para pequenas funções e setters de propriedade. Essas verificações evitam o inlining e causam poluição substancial do cache de instruções. Métodos auxiliares de lançamento, como ArgumentNullException.ThrowIfNull são mais simples e eficientes do if que blocos que constroem uma nova instância de exceção.

Exemplo

O trecho de código a seguir mostra uma violação de CA1510:

void M(string arg)
{
    if (arg is null)
        throw new ArgumentNullException(nameof(arg));
}

O trecho de código a seguir mostra a correção:

void M(string arg)
{
    ArgumentNullException.ThrowIfNull(arg);
}

Como corrigir violações

Substitua o if bloco que lança a exceção por uma chamada para ArgumentNullException.ThrowIfNull. Ou, no Visual Studio, use o menu de lâmpada para corrigir seu código automaticamente.

Quando suprimir avisos

É seguro suprimir uma violação dessa regra se você não estiver preocupado com a capacidade de manutenção do seu código. Também é bom suprimir violações que são identificadas como falsos positivos.

Suprimir um aviso

Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.

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

Para desabilitar a regra de um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração.

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

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Partilhar via