CA1511: Usar o auxiliar de lançamento ArgumentException

Artigo
12/16/2023

Property	valor
ID da regra	CA1511
Título	Usar o auxiliar de lançamento ArgumentException
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 ou uma cadeia de caracteres vazia e, em seguida, condicionalmente lança um ArgumentExceptionarquivo .

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 ArgumentException.ThrowIfNullOrEmpty(String, String) 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 CA1511:

void M(string arg)
{
    if (string.IsNullOrEmpty(arg))
        throw new ArgumentException("", "arg");
}

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

void M(string arg)
{
    ArgumentException.ThrowIfNullOrEmpty(arg);
}

Como corrigir violações

Substitua o if bloco que lança a exceção por uma chamada para ArgumentException.ThrowIfNullOrEmpty(String, String). 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 CA1511
// The code that's violating the rule is on this line.
#pragma warning restore CA1511

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

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

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

Partilhar via