CA1310: Especifique StringComparison para precisão

Motivo

Uma operação de comparação de cadeia de caracteres usa uma sobrecarga de método sem definir o parâmetro StringComparison e recorre à comparação de cadeia de caracteres específica da cultura por padrão. Portanto, seu comportamento variará com base nas configurações de localidade do usuário atual.

Descrição da regra

Um método de comparação de cadeia de caracteres que usa a comparação de cadeia de caracteres específica da cultura por padrão pode ter um comportamento de tempo de execução potencialmente não intencional que não corresponde à intenção do usuário. Recomenda-se usar a sobrecarga com o parâmetro StringComparison para garantir a correção e a clareza de intenção.

Esta regra sinaliza métodos de comparação de cadeia de caracteres que usam o valor específico StringComparison da cultura por padrão. Para obter mais informações, consulte Comparações de string que usam a cultura atual.

Como corrigir violações

Para corrigir uma violação desta regra, altere os métodos de comparação de cadeias de caracteres para versões sobrecarregadas que aceitem a enumeração StringComparison como parâmetro. Por exemplo, altere String.Compare(str1, str2) para String.Compare(str1, str2, StringComparison.Ordinal).

Quando suprimir avisos

É seguro suprimir um aviso dessa regra quando a biblioteca ou o aplicativo não se destina a ser localizado.

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 CA1310
// The code that's violating the rule is on this line.
#pragma warning restore CA1310

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

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

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

Consulte também

• Práticas recomendadas para usar cadeias de caracteres no .NET
• Regras de globalização
• CA1307: Especifique StringComparison para maior clareza
• CA1309: Use comparação ordinal de cadeias