Compartilhar via


StringComparer.CurrentCultureIgnoreCase Propriedade

Definição

Obtém um objeto StringComparer que executa comparações de cadeia de caracteres que não diferenciam maiúsculas de minúsculas, usando as regras de comparação de palavras da cultura atual.

public:
 static property StringComparer ^ CurrentCultureIgnoreCase { StringComparer ^ get(); };
public static StringComparer CurrentCultureIgnoreCase { get; }
member this.CurrentCultureIgnoreCase : StringComparer
Public Shared ReadOnly Property CurrentCultureIgnoreCase As StringComparer

Valor da propriedade

StringComparer

Um novo objeto para comparação de cadeia de caracteres.

Comentários

A cultura atual é o CultureInfo objeto associado ao thread atual; ele é retornado pela CultureInfo.CurrentCulture propriedade.

O StringComparer retornado pela propriedade pode ser usado quando cadeias CurrentCultureIgnoreCase de caracteres são linguisticamente relevantes, mas seu caso não é. Por exemplo, se as cadeias de caracteres forem exibidas para o usuário, mas o caso não for importante, a comparação de cadeia de caracteres que diferencia a cultura e não diferencia maiúsculas de minúsculas deverá ser usada para ordenar os dados da cadeia de caracteres.

Observação

.NET Core em execução somente em sistemas Linux e macOS: O comportamento de collation para as culturas C e Posix é sempre sensível a minúsculas porque essas culturas não usam a ordem de collation Unicode esperada. Recomendamos usar uma cultura diferente de C ou Posix para executar operações de classificação que diferenciam culturas e maiúsculas de minúsculas.

Na CurrentCultureIgnoreCase verdade, a propriedade retorna uma instância de uma classe anônima derivada da StringComparer classe.

Cada chamada para o CurrentCultureIgnoreCase acessador de propriedade get retorna um novo StringComparer objeto, como mostra o código a seguir.

private void CompareCurrentCultureInsensitiveStringComparer()
{
   StringComparer stringComparer1, stringComparer2;
   stringComparer1 = StringComparer.CurrentCultureIgnoreCase;
   stringComparer2 = StringComparer.CurrentCultureIgnoreCase;
   // Displays false
   Console.WriteLine(StringComparer.ReferenceEquals(stringComparer1, 
                                                    stringComparer2));
}
let compareCurrentCultureInsensitiveStringComparer () =
    let stringComparer1 = StringComparer.CurrentCultureIgnoreCase
    let stringComparer2 = StringComparer.CurrentCultureIgnoreCase
    // Displays false
    printfn $"{StringComparer.ReferenceEquals(stringComparer1, stringComparer2)}"
Private Sub CompareCurrentCultureInsensitiveStringComparers()
   Dim stringComparer1, stringComparer2 As StringComparer
   stringComparer1 = StringComparer.CurrentCultureIgnoreCase
   stringComparer2 = StringComparer.CurrentCultureIgnoreCase
   ' Displays False
   Console.WriteLine(StringComparer.ReferenceEquals(stringComparer1, _
                                                    stringComparer2))
End Sub

Para melhorar o desempenho, você pode armazenar o StringComparer objeto em uma variável local em vez de recuperar o valor da CurrentCultureIgnoreCase propriedade várias vezes.

Aplica-se a

Confira também