StringComparer.CurrentCultureIgnoreCase Propriedade

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.Extensions.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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