CA1310: Especificar StringComparison para garantir a exatidão

Causa

Uma operação de comparação de cadeia de caracteres usa uma sobrecarga de método que não define um parâmetro StringComparison e usa, por padrão, uma comparação de cadeia de caracteres específica da cultura. Portanto, seu comportamento variará de acordo com as configurações de localidade do usuário atual.

Descrição da regra

Um método de comparação de cadeia de caracteres que usa, por padrão, a comparação de cadeia de caracteres específica da cultura pode ter um comportamento de runtime potencialmente não intencional que não corresponda à intenção do usuário. É recomendável que você use a sobrecarga com o parâmetro StringComparison para garantir a exatidão e a clareza da intenção.

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

Como corrigir violações

Para corrigir uma violação dessa regra, altere os métodos de comparação de strings para sobrecargas 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 ignorar uma mensagem de aviso dessa regra quando a biblioteca ou o aplicativo não é destinado à localizaçã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 CA1310
// The code that's violating the rule is on this line.
#pragma warning restore CA1310

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.CA1310.severity = none

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

Confira também

• Práticas recomendadas para o uso de cadeias de caracteres no .NET
• Regras de globalização
• CA1307: Especificar StringComparison para garantir a clareza
• CA1309: Usar StringComparison ordinal