CA1858: usar "StartsWith" em vez de "IndexOf"

Artigo
09/07/2023

Property	Valor
ID da regra	CA1858
Título	Usar StartsWith em vez de IndexOf
Categoria	Desempenho
Correção interruptiva ou sem interrupção	Sem interrupção
Habilitado por padrão no .NET 9	Como sugestão

Causa

String.IndexOf é chamado e o resultado é comparado com zero.

Descrição da regra

É mais eficiente e mais claro chamar String.StartsWith do que chamar String.IndexOf e comparar o resultado com zero para determinar se uma cadeia de caracteres começa com um determinado prefixo.

IndexOf pesquisa a cadeia de caracteres inteira, enquanto StartsWith só a compara no início da cadeia de caracteres.

Como corrigir violações

Substitua a chamada para String.IndexOf por uma chamada para String.StartsWith.

Exemplo

O seguinte snippet de código mostra uma violação do CA1858:

bool M(string s)
{
    return s.IndexOf("abc") == 0;
}

Function M(s As String) As Boolean
    Return s.IndexOf("abc") = 0
End Function

O seguinte snippet de código conserta a violação:

bool M(string s)
{
    return s.StartsWith("abc");
}

Function M(s As String) As Boolean
    Return s.StartsWith("abc")
End Function

Quando suprimir avisos

É seguro fechar esse aviso se o desempenho não é uma preocupação.

Suprimir um aviso

Para suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem a fim de desabilitar e, em seguida, reabilitar a regra.

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

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

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

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

Compartilhar via