CompareInfo Classe

Definição

Espaço de Nomes:
System.Globalization
Assemblagens:
mscorlib.dll, System.Globalization.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Globalization.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
CompareInfo.cs
Origem:
CompareInfo.cs
Origem:
CompareInfo.cs
Origem:
CompareInfo.cs
Origem:
CompareInfo.cs

Implementa um conjunto de métodos para comparações de cordas sensíveis à cultura.

public ref class CompareInfo
public ref class CompareInfo sealed : System::Runtime::Serialization::IDeserializationCallback
public ref class CompareInfo : System::Runtime::Serialization::IDeserializationCallback
public class CompareInfo
public sealed class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
[System.Serializable]
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallback
type CompareInfo = class
type CompareInfo = class
    interface IDeserializationCallback
[<System.Serializable>]
type CompareInfo = class
    interface IDeserializationCallback
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CompareInfo = class
    interface IDeserializationCallback
Public Class CompareInfo
Public NotInheritable Class CompareInfo
Implements IDeserializationCallback
Public Class CompareInfo
Implements IDeserializationCallback
Herança
Object
CompareInfo
Atributos
SerializableAttribute ComVisibleAttribute
Implementações
IDeserializationCallback

Observações

As convenções para comparar e classificar dados variam de cultura para cultura. Por exemplo, a ordem de classificação pode ser baseada na fonética ou na representação visual de caracteres. Nas línguas do Leste Asiático, os caracteres são ordenados pelo traçado e o radical dos ideógrafos. A classificação também depende da ordem que as línguas e culturas usam para o alfabeto. Por exemplo, a língua dinamarquesa tem um caractere "Æ" que vem após o "Z" no alfabeto. Além disso, as comparações podem ser sensíveis a maiúsculas e minúsculas ou insensíveis a essas diferenças, e as regras de capitalização podem também diferir de acordo com a cultura. A CompareInfo classe é responsável por manter esses dados de comparação de cadeia de caracteres sensíveis à cultura e por executar operações de cadeia de caracteres sensíveis à cultura.

Normalmente, não é necessário instanciar um CompareInfo objeto diretamente, porque um é usado implicitamente por todas as operações de comparação de cadeia de caracteres não ordinais, incluindo chamadas para o String.Compare método. No entanto, se você quiser recuperar um CompareInfo objeto, poderá fazê-lo de uma destas maneiras:

Valores de pesquisa ignorados

Os conjuntos de caracteres incluem caracteres ignoráveis, que são caracteres que não são considerados ao realizar uma comparação sensível à cultura ou linguística. Métodos de comparação como IndexOf e LastIndexOf não consideram tais caracteres quando realizam uma comparação sensível à cultura. Caracteres que podem ser ignorados incluem:

  • String.Empty. Os métodos de comparação sensíveis à cultura sempre encontrarão uma cadeia de caracteres vazia no início (índice zero) da cadeia de caracteres que está sendo pesquisada.

  • Um caractere ou uma cadeia de caracteres que consiste em caracteres com pontos de código que não são considerados na operação devido a opções de comparação. Em particular, as opções CompareOptions.IgnoreNonSpace e CompareOptions.IgnoreSymbols produzem pesquisas nas quais símbolos e caracteres de combinação não espaçáveis são ignorados.

  • Uma cadeia de caracteres com pontos de código que não têm significado linguístico. Por exemplo, um hífen suave (U+00AD) é sempre ignorado numa comparação de sequência de caracteres sensível à cultura.

Considerações de segurança

Se uma decisão de segurança depender de uma comparação de cadeia de caracteres ou de uma alteração de maiúsculas e minúsculas, você deverá usar a InvariantCulture propriedade para garantir que o comportamento seja consistente, independentemente das configurações de cultura do sistema operacional.

Note

Quando possível, você deve usar métodos de comparação de cadeia de caracteres que tenham um parâmetro do tipo CompareOptions para especificar o tipo de comparação esperado. Como regra geral, use opções linguísticas (usando a cultura atual) para comparar cadeias de caracteres exibidas na interface do usuário e especificar Ordinal ou OrdinalIgnoreCase para comparações de segurança.

Example

  The following example shows how the <xref:System.Globalization.CompareInfo> object associated with a <xref:System.Globalization.CultureInfo> object affects string comparison.

  :::code language="csharp" source="~/snippets/csharp/System.Globalization/CompareInfo/Overview/CompareInfo.cs" id="Snippet1":::
  :::code language="vb" source="~/snippets/visualbasic/System.Globalization/CompareInfo/Overview/CompareInfo.vb" id="Snippet1":::

Propriedades

Name Descrição
LCID

Obtém o identificador de cultura corretamente formado para o atual CompareInfo.
Name

Recebe o nome da cultura usada para operações de ordenação por este CompareInfo objeto.
Version

Obtém informações sobre a versão do Unicode usada para comparar e ordenar strings.

Métodos

Name Descrição
Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Compara dois intervalos de caracteres em modo apenas leitura.
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)

Compara uma secção de uma cadeia com uma secção de outra cadeia usando o valor especificado CompareOptions .
Compare(String, Int32, Int32, String, Int32, Int32)

Compara uma secção de uma corda com uma secção de outra corda.
Compare(String, Int32, String, Int32, CompareOptions)

Compara a secção final de uma cadeia com a secção final de outra cadeia usando o valor especificado CompareOptions .
Compare(String, Int32, String, Int32)

Compara a secção final de uma corda com a secção final de outra corda.
Compare(String, String, CompareOptions)

Compara duas cadeias usando o valor especificado CompareOptions .
Compare(String, String)

Compara duas cadeias de caracteres.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual CompareInfo .
GetCompareInfo(Int32, Assembly)

Inicializa um novo CompareInfo objeto associado à cultura especificada e que utiliza métodos de comparação de strings no .Assembly
GetCompareInfo(Int32)

Inicializa um novo CompareInfo objeto associado à cultura com o identificador especificado.
GetCompareInfo(String, Assembly)

Inicializa um novo CompareInfo objeto associado à cultura especificada e que utiliza métodos de comparação de strings no .Assembly
GetCompareInfo(String)

Inicializa um novo CompareInfo objeto associado à cultura com o nome especificado.
GetHashCode()

Serve como função de hash para o atual CompareInfo para algoritmos de hash e estruturas de dados, como uma tabela de hash.
GetHashCode(ReadOnlySpan<Char>, CompareOptions)

Obtém o código de hash para um espaço de caracteres com base nas opções de comparação especificadas.
GetHashCode(String, CompareOptions)

Obtém o código hash de uma string com base nas opções de comparação especificadas.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)

Calcula uma chave de ordenação para a entrada especificada.
GetSortKey(String, CompareOptions)

Obtém um SortKey objeto para a cadeia especificada usando o valor especificado CompareOptions .
GetSortKey(String)

Obtém a chave de ordenação para a cadeia especificada.
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)

Obtém o número total de bytes de chave de ordenação que seriam produzidos a partir da entrada especificada.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Pesquisa pela primeira ocorrência de uma subcadeia dentro de uma cadeia de origem.
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Pesquisas pela primeira ocorrência de uma substring dentro do intervalo especificado de caracteres de apenas leitura.
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)

Pesquisas pela primeira ocorrência de a Rune dentro do intervalo especificado de caracteres de apenas leitura.
IndexOf(String, Char, CompareOptions)

Procura o carácter especificado e devolve o índice baseado em zero da primeira ocorrência dentro de toda a cadeia de origem usando o valor especificado CompareOptions .
IndexOf(String, Char, Int32, CompareOptions)

Procura o carácter especificado e devolve o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que se estende do índice especificado até ao fim da cadeia usando o valor especificado CompareOptions .
IndexOf(String, Char, Int32, Int32, CompareOptions)

Procura o carácter especificado e devolve o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que começa no índice especificado e contém o número especificado de elementos usando o valor especificado CompareOptions .
IndexOf(String, Char, Int32, Int32)

Procura o carácter especificado e devolve o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que começa no índice especificado e contém o número especificado de elementos.
IndexOf(String, Char, Int32)

Procura o carácter especificado e devolve o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que se estende do índice especificado até ao fim da cadeia.
IndexOf(String, Char)

Procura o carácter especificado e retorna o índice baseado em zero da primeira ocorrência dentro de toda a cadeia de origem.
IndexOf(String, String, CompareOptions)

Procura a subcadeia especificada e devolve o índice baseado em zero da primeira ocorrência dentro de toda a cadeia de origem usando o valor especificado CompareOptions .
IndexOf(String, String, Int32, CompareOptions)

Procura a subcadeia especificada e retorna o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que se estende do índice especificado até ao fim da cadeia usando o valor especificado CompareOptions .
IndexOf(String, String, Int32, Int32, CompareOptions)

Procura a subcadeia especificada e devolve o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que começa no índice especificado e contém o número especificado de elementos usando o valor especificado CompareOptions .
IndexOf(String, String, Int32, Int32)

Procura a subcadeia especificada e retorna o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que começa no índice especificado e contém o número especificado de elementos.
IndexOf(String, String, Int32)

Procura a subcadeia especificada e retorna o índice baseado em zero da primeira ocorrência dentro da secção da cadeia de origem que se estende do índice especificado até ao fim da cadeia.
IndexOf(String, String)

Procura a subcadeia especificada e retorna o índice baseado em zero da primeira ocorrência dentro de toda a cadeia de origem.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Determina se uma cadeia começa com um prefixo específico.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Determina se um intervalo de caracteres apenas de leitura começa com um prefixo específico.
IsPrefix(String, String, CompareOptions)

Determina se a cadeia de origem especificada começa com o prefixo especificado usando o valor especificado CompareOptions .
IsPrefix(String, String)

Determina se a cadeia de origem especificada começa com o prefixo especificado.
IsSortable(Char)

Indica se um carácter Unicode especificado é ordenável.
IsSortable(ReadOnlySpan<Char>)

Indica se um intervalo Unicode especificado de caracteres apenas de leitura é ordenável.
IsSortable(Rune)

Indica se um especificado Rune é ordenável.
IsSortable(String)

Indica se uma cadeia Unicode especificada é sortável.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Determina se uma cadeia termina com um sufixo específico.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Determina se um intervalo de caracteres apenas de leitura termina com um sufixo específico.
IsSuffix(String, String, CompareOptions)

Determina se a cadeia de origem especificada termina com o sufixo especificado usando o valor especificado CompareOptions .
IsSuffix(String, String)

Determina se a cadeia de origem especificada termina com o sufixo especificado.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Pesquisa pela última ocorrência de uma subcadeia dentro de uma cadeia de origem.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Pesquisas pela última ocorrência de uma substring dentro do intervalo especificado de apenas leitura de caracteres.
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)

Pesquisas pela última ocorrência de a Rune dentro do intervalo especificado de caracteres de apenas leitura.
LastIndexOf(String, Char, CompareOptions)

Procura o carácter especificado e devolve o índice em base zero da última ocorrência dentro de toda a cadeia de origem usando o valor especificado CompareOptions .
LastIndexOf(String, Char, Int32, CompareOptions)

Procura o carácter especificado e devolve o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que se estende do início da cadeia até ao índice especificado usando o valor especificado CompareOptions .
LastIndexOf(String, Char, Int32, Int32, CompareOptions)

Procura o carácter especificado e retorna o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que contém o número especificado de elementos e termina no índice especificado usando o valor especificado CompareOptions .
LastIndexOf(String, Char, Int32, Int32)

Procura o carácter especificado e devolve o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que contém o número especificado de elementos e termina no índice especificado.
LastIndexOf(String, Char, Int32)

Procura o carácter especificado e devolve o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que se estende do início da cadeia até ao índice especificado.
LastIndexOf(String, Char)

Procura o carácter especificado e retorna o índice baseado em zero da última ocorrência dentro de toda a cadeia de origem.
LastIndexOf(String, String, CompareOptions)

Procura a substring especificada e devolve o índice baseado em zero da última ocorrência dentro de toda a cadeia de origem usando o valor especificado CompareOptions .
LastIndexOf(String, String, Int32, CompareOptions)

Procura a subcadeia especificada e devolve o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que se estende do início da cadeia até ao índice especificado usando o valor especificado CompareOptions .
LastIndexOf(String, String, Int32, Int32, CompareOptions)

Procura a subcadeia especificada e devolve o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que contém o número especificado de elementos e termina no índice especificado usando o valor especificado CompareOptions .
LastIndexOf(String, String, Int32, Int32)

Procura a subcadeia especificada e devolve o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que contém o número especificado de elementos e termina no índice especificado.
LastIndexOf(String, String, Int32)

Procura a subcadeia especificada e devolve o índice baseado em zero da última ocorrência dentro da secção da cadeia de origem que se estende do início da cadeia até ao índice especificado.
LastIndexOf(String, String)

Procura a subcadeia especificada e devolve o índice baseado em zero da última ocorrência dentro de toda a cadeia de origem.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual CompareInfo .

Implementações de Interface Explícita

Name Descrição
IDeserializationCallback.OnDeserialization(Object)

Executa-se quando todo o grafo de objeto foi desserializado.

Métodos da Extensão

Name Descrição
GetStringComparer(CompareInfo, CompareOptions)

Devolve um StringComparer objeto com base nas regras de comparação de cordas sensíveis à cultura de um objeto especificado CompareInfo .

Aplica-se a

Ver também