StringComparer.CurrentCultureIgnoreCase Propriedade

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.Extensions.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
netstandard.dll

Obtém um StringComparer objeto que realiza comparações de cadeias insensíveis a maiúsculas 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; }
static member CurrentCultureIgnoreCase : StringComparer
Public Shared ReadOnly Property CurrentCultureIgnoreCase As StringComparer

Valor de Propriedade

StringComparer

Um novo objeto para comparação de cordas.

Observações

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

O StringComparer retorno pela CurrentCultureIgnoreCase propriedade pode ser usado quando as cadeias são linguisticamente relevantes, mas o seu caso não é. Por exemplo, se as strings forem exibidas ao utilizador mas o caso for pouco importante, deve ser usada uma comparação de strings sensível à cultura e insensível a maiúsculas minúsculas para ordenar os dados da cadeia.

Note

.NET Core apenas em execução em sistemas Linux e macOS: O comportamento de agrupamento para as culturas C e Posix diferencia sempre maiúsculas e minúsculas porque essas culturas não usam a ordenação Unicode esperada. Recomendamos que você use uma cultura diferente de C ou Posix para executar operações de classificação sensíveis à cultura e que não diferenciam maiúsculas de minúsculas.

A CurrentCultureIgnoreCase propriedade devolve na verdade uma instância de uma classe anónima derivada da StringComparer classe.

Cada chamada ao CurrentCultureIgnoreCase acessório de propriedade get devolve um novo StringComparer objeto, como mostra o código seguinte.

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, pode armazenar o StringComparer objeto numa variável local em vez de recuperar o valor da CurrentCultureIgnoreCase propriedade várias vezes.

Aplica-se a

Ver também