CompareInfo Classe

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

CompareInfo.cs

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

public ref class CompareInfo sealed : System::Runtime::Serialization::IDeserializationCallback

public sealed class CompareInfo : System.Runtime.Serialization.IDeserializationCallback

type CompareInfo = class
    interface IDeserializationCallback

Public NotInheritable Class CompareInfo
Implements IDeserializationCallback

Herança

Object

CompareInfo

Implementações

IDeserializationCallback

Exemplos

O exemplo a seguir mostra como o CompareInfo objeto associado a um CultureInfo objeto afeta a comparação de cadeia de caracteres.

using namespace System;
using namespace System::Text;
using namespace System::Globalization;

int main()
{
    array<String^>^ sign = gcnew array<String^> { "<", "=", ">" };

    // The code below demonstrates how strings compare
    // differently for different cultures.
    String^ s1 = "Coté"; 
    String^ s2 = "coté";
    String^ s3 = "côte";

    // Set sort order of strings for French in France.
    CompareInfo^ ci = (gcnew CultureInfo("fr-FR"))->CompareInfo;
    Console::WriteLine(L"The LCID for {0} is {1}.", ci->Name, ci->LCID);

    // Display the result using fr-FR Compare of Coté = coté.
    Console::WriteLine(L"fr-FR Compare: {0} {2} {1}",
        s1, s2, sign[ci->Compare(s1, s2, CompareOptions::IgnoreCase) + 1]);

    // Display the result using fr-FR Compare of coté > côte.
    Console::WriteLine(L"fr-FR Compare: {0} {2} {1}",
        s2, s3, sign[ci->Compare(s2, s3, CompareOptions::None) + 1]);

    // Set sort order of strings for Japanese as spoken in Japan.
    ci = (gcnew CultureInfo("ja-JP"))->CompareInfo;
    Console::WriteLine(L"The LCID for {0} is {1}.", ci->Name, ci->LCID);

    // Display the result using ja-JP Compare of coté < côte.
    Console::WriteLine("ja-JP Compare: {0} {2} {1}",
        s2, s3, sign[ci->Compare(s2, s3) + 1]);
}

// This code produces the following output.
//
// The LCID for fr-FR is 1036.
// fr-FR Compare: Coté = coté
// fr-FR Compare: coté > côte
// The LCID for ja-JP is 1041.
// ja-JP Compare: coté < côte

using System;
using System.Text;
using System.Globalization;

public sealed class App
{
    static void Main(string[] args)
    {
        String[] sign = new String[] { "<", "=", ">" };

        // The code below demonstrates how strings compare
        // differently for different cultures.
        String s1 = "Coté", s2 = "coté", s3 = "côte";

        // Set sort order of strings for French in France.
        CompareInfo ci = new CultureInfo("fr-FR").CompareInfo;
        Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID);

        // Display the result using fr-FR Compare of Coté = coté.  	
        Console.WriteLine("fr-FR Compare: {0} {2} {1}",
            s1, s2, sign[ci.Compare(s1, s2, CompareOptions.IgnoreCase) + 1]);

        // Display the result using fr-FR Compare of coté > côte.
        Console.WriteLine("fr-FR Compare: {0} {2} {1}",
            s2, s3, sign[ci.Compare(s2, s3, CompareOptions.None) + 1]);

        // Set sort order of strings for Japanese as spoken in Japan.
        ci = new CultureInfo("ja-JP").CompareInfo;
        Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID);

        // Display the result using ja-JP Compare of coté < côte.
        Console.WriteLine("ja-JP Compare: {0} {2} {1}",
            s2, s3, sign[ci.Compare(s2, s3) + 1]);
    }
}

// This code produces the following output.
//
// The LCID for fr-FR is 1036.
// fr-FR Compare: Coté = coté
// fr-FR Compare: coté > côte
// The LCID for ja-JP is 1041.
// ja-JP Compare: coté < côte

Imports System.Text
Imports System.Globalization

NotInheritable Public Class App
    Shared Sub Main(ByVal args() As String) 
        Dim sign() As String = {"<", "=", ">"}
        
        ' The code below demonstrates how strings compare 
        ' differently for different cultures.
        Dim s1 As String = "Coté"
        Dim s2 As String = "coté"
        Dim s3 As String = "côte"
        
        ' Set sort order of strings for French in France.
        Dim ci As CompareInfo = New CultureInfo("fr-FR").CompareInfo
        Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID)
        
        ' Display the result using fr-FR Compare of Coté = coté.  	
        Console.WriteLine("fr-FR Compare: {0} {2} {1}", _
                          s1, s2, sign((ci.Compare(s1, s2, CompareOptions.IgnoreCase) + 1)))
        
        ' Display the result using fr-FR Compare of coté > côte.
        Console.WriteLine("fr-FR Compare: {0} {2} {1}", _
                          s2, s3, sign((ci.Compare(s2, s3, CompareOptions.None) + 1)))
        
        ' Set sort order of strings for Japanese as spoken in Japan.
        ci = New CultureInfo("ja-JP").CompareInfo
        Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID)
        
        ' Display the result using ja-JP Compare of coté < côte. 
        Console.WriteLine("ja-JP Compare: {0} {2} {1}", _
                          s2, s3, sign((ci.Compare(s2, s3) + 1)))
    End Sub
End Class

' This code produces the following output.
' 
' The LCID for fr-FR is 1036.
' fr-FR Compare: Coté = coté
' fr-FR Compare: coté > côte
' The LCID for ja-JP is 1041.
' ja-JP Compare: coté < côte

Comentários

Para obter mais informações sobre essa API, consulte Comentários de API complementares para CompareInfo.

Propriedades

LCID	Obtém o identificador de cultura formado corretamente para o CompareInfo atual.
Name	Obtém o nome da cultura usada para operações de classificação por este objeto CompareInfo.
Version	Obtém informações sobre a versão de Unicode usada para comparar e classificar cadeias de caracteres.

Métodos

Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Compara dois intervalos somente leitura de caracteres.
Compare(String, Int32, Int32, String, Int32, Int32)	Compara uma seção de uma cadeia de caracteres com uma seção de outra.
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)	Compara uma seção de uma cadeia de caracteres com uma seção de outra usando o valor de CompareOptions especificado.
Compare(String, Int32, String, Int32)	Compara a seção final de uma cadeia de caracteres com a seção final de outra.
Compare(String, Int32, String, Int32, CompareOptions)	Compara a seção final de uma cadeia de caracteres com a seção final de outra usando o valor de CompareOptions especificado.
Compare(String, String)	Compara duas cadeias de caracteres.
Compare(String, String, CompareOptions)	Compara duas cadeias de caracteres usando o valor CompareOptions especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto CompareInfo atual.
GetCompareInfo(Int32)	Inicializa um novo objeto CompareInfo associado à cultura com o identificador especificado.
GetCompareInfo(Int32, Assembly)	Inicializa um novo objeto CompareInfo que está associado com a cultura especificada e que usa métodos de comparação de cadeia de caracteres no Assembly especificado.
GetCompareInfo(String)	Inicializa um novo objeto CompareInfo associado à cultura com o nome especificado.
GetCompareInfo(String, Assembly)	Inicializa um novo objeto CompareInfo que está associado com a cultura especificada e que usa métodos de comparação de cadeia de caracteres no Assembly especificado.
GetHashCode()	Funciona como uma função de hash para o CompareInfo atual, para algoritmos de hash e estruturas de dados, como uma tabela de hash.
GetHashCode(ReadOnlySpan<Char>, CompareOptions)	Obtém o código hash de um intervalo de caracteres com base nas opções de comparação especificadas.
GetHashCode(String, CompareOptions)	Obtém o código hash de uma cadeia de caracteres com base nas opções de comparação especificadas.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)	Calcula uma chave de classificação para a entrada especificada.
GetSortKey(String)	Obtém a chave de classificação da cadeia de caracteres especificada.
GetSortKey(String, CompareOptions)	Obtém um objeto SortKey para a cadeia de caracteres especificada usando o valor CompareOptions especificado.
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)	Obtém o número total de bytes de chave de classificação que seriam produzidos com base na entrada especificada.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Pesquisa a primeira ocorrência de uma substring dentro do intervalo de caracteres somente leitura especificado.
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Pesquisa pela primeira ocorrência de uma substring dentro de uma cadeia de caracteres de origem.
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Pesquisa a primeira ocorrência de um Rune dentro do intervalo de caracteres somente leitura especificado.
IndexOf(String, Char)	Pesquisa a cadeia de caracteres especificada e retorna o índice baseado em zero da primeira ocorrência em toda a cadeia de caracteres de origem.
IndexOf(String, Char, CompareOptions)	Pesquisa a cadeia de caracteres especificada e retorna o índice baseado em zero da primeira ocorrência em toda a cadeia de caracteres de origem usando o valor CompareOptions especificado.
IndexOf(String, Char, Int32)	Pesquisa o caractere especificado e retorna o índice baseado em zero da primeira ocorrência dentro da seção da cadeia de caracteres de origem que se estende do índice especificado ao final da cadeia de caracteres.
IndexOf(String, Char, Int32, CompareOptions)	Pesquisa o caractere especificado e retorna o índice baseado em zero da primeira ocorrência dentro da seção da cadeia de caracteres de origem que se estende do índice especificado ao final da cadeia de caracteres usando o valor de CompareOptions especificado.
IndexOf(String, Char, Int32, Int32)	Pesquisa o caractere especificado e retorna o índice baseado em zero da primeira ocorrência dentro da seção da cadeia de caracteres de origem, que começa no índice especificado e contém o número de elementos especificado.
IndexOf(String, Char, Int32, Int32, CompareOptions)	Pesquisa o caractere especificado e retorna o índice baseado em zero da primeira ocorrência dentro de uma seção da cadeia de caracteres de origem que começa no índice especificado e contém o número de elementos especificado usando o valor CompareOptions especificado.
IndexOf(String, String)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da primeira ocorrência em toda a cadeia de caracteres de origem.
IndexOf(String, String, CompareOptions)	Pesquisa a subcadeia de caracteres especificada e retorna o índice com base em zero da primeira ocorrência dentro de toda a cadeia de caracteres de origem usando o valor CompareOptions especificado.
IndexOf(String, String, Int32)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da primeira ocorrência dentro da seção da cadeia de caracteres que se estende do índice especificado para o final da cadeia de caracteres.
IndexOf(String, String, Int32, CompareOptions)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da primeira ocorrência dentro da seção da cadeia de caracteres de origem que se estende do índice especificado ao final da cadeia de caracteres usando o valor de CompareOptions especificado.
IndexOf(String, String, Int32, Int32)	Pesquisa a subcadeia de caracteres especificadas e retorna o índice baseado em zero da primeira ocorrência dentro da seção da cadeia de caracteres de origem, que começa no índice especificado e contém o número de elementos especificado.
IndexOf(String, String, Int32, Int32, CompareOptions)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da primeira ocorrência dentro de uma seção da cadeia de caracteres de origem que começa no índice especificado e contém o número de elementos especificado usando o valor CompareOptions especificado.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se um intervalo de caracteres somente leitura começa com um prefixo específico.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se uma cadeia de caracteres começa com um prefixo específico.
IsPrefix(String, String)	Determina se a cadeia de caracteres de origem determinada começa com o prefixo especificado.
IsPrefix(String, String, CompareOptions)	Determina se a cadeia de caracteres de origem determinada começa com o prefixo dado usando o valor CompareOptions especificado.
IsSortable(Char)	Indica se um caractere Unicode especificado é classificável.
IsSortable(ReadOnlySpan<Char>)	Indica se um intervalo de caracteres somente leitura Unicode especificado é classificável.
IsSortable(Rune)	Indica se um Rune especificado é classificável.
IsSortable(String)	Indica se uma cadeira de caracteres Unicode especificada é classificável.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se um intervalo de caracteres somente leitura termina com um sufixo específico.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se uma cadeia de caracteres começa com um sufixo específico.
IsSuffix(String, String)	Determina se a cadeia de caracteres de origem especificada termina com o prefixo especificado.
IsSuffix(String, String, CompareOptions)	Determina se a cadeia de caracteres de origem determinada termina com o sufixo especificado usando o valor CompareOptions especificado.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Pesquisa a última ocorrência de uma substring dentro do intervalo de caracteres somente leitura especificado.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Pesquisa pela última ocorrência de uma substring dentro de uma cadeia de caracteres de origem.
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Pesquisa a última ocorrência de um Rune dentro do intervalo de caracteres somente leitura especificado.
LastIndexOf(String, Char)	Pesquisa pelo caractere especificado e retorna o índice baseado em zero da última ocorrência em toda a cadeia de caracteres de origem.
LastIndexOf(String, Char, CompareOptions)	Pesquisa pelo caractere especificado e retorna o índice baseado em zero da última ocorrência em toda a cadeia de caracteres de origem usando o valor CompareOptions especificado.
LastIndexOf(String, Char, Int32)	Pesquisa o caractere especificado e retorna o índice baseado em zero da última ocorrência na seção da cadeia de caracteres de origem que se estende do início da cadeia de caracteres até o índice especificado.
LastIndexOf(String, Char, Int32, CompareOptions)	Pesquisa o caractere especificado e retorna o índice baseado em zero da última ocorrência na seção da cadeia de caracteres de origem que se estende do início da cadeia de caracteres até o índice especificado, usando o valor CompareOptions especificado.
LastIndexOf(String, Char, Int32, Int32)	Pesquisa o caractere especificado e retorna o índice baseado em zero da última ocorrência dentro da seção da cadeia de caracteres de origem que contém o número especificado de elementos e termina no índice especificado.
LastIndexOf(String, Char, Int32, Int32, CompareOptions)	Pesquisa o caractere especificado e retorna o índice baseado em zero da última ocorrência dentro da seção da cadeia de caracteres de origem que contém o número especificado de elementos e termina no índice especificado usando o valor CompareOptions especificado.
LastIndexOf(String, String)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da última ocorrência em toda a cadeia de caracteres de origem.
LastIndexOf(String, String, CompareOptions)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da última ocorrência dentro de toda a cadeia de caracteres usando o valor CompareOptions especificado.
LastIndexOf(String, String, Int32)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da última ocorrência na seção da cadeia de caracteres de origem que se estende do início da cadeia de caracteres até o índice especificado.
LastIndexOf(String, String, Int32, CompareOptions)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da última ocorrência na seção da cadeia de caracteres de origem que se estende do início da cadeia de caracteres até o índice especificado, usando o valor CompareOptions especificado.
LastIndexOf(String, String, Int32, Int32)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da última ocorrência dentro da seção da cadeia de caracteres de origem que contém o número especificado de elementos e termina no índice especificado.
LastIndexOf(String, String, Int32, Int32, CompareOptions)	Pesquisa a subcadeia de caracteres especificada e retorna o índice baseado em zero da última ocorrência dentro da seção da cadeia de caracteres de origem que contém o número especificado de elementos e termina no índice especificado usando o valor CompareOptions especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto CompareInfo atual.

Implantações explícitas de interface

IDeserializationCallback.OnDeserialization(Object)

É executado quando o todo o grafo de objeto tiver sido desserializado.

Métodos de Extensão

GetStringComparer(CompareInfo, CompareOptions)

Retorna um objeto StringComparer com base nas regras de comparação de cadeia de caracteres que fazem distinção entre culturas de um objeto CompareInfo especificado.

Confira também

• Classificando tabelas de peso para sistemas operacionais Windows
• Tabela de elementos de ordenação Unicode padrão para Linux e macOS