CompareInfo Classe

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Origine:

CompareInfo.cs

Implementa un insieme di metodi per i confronti tra stringhe sensibili alle impostazioni 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

Ereditarietà

Object

CompareInfo

Implementazioni

IDeserializationCallback

Esempio

Nell'esempio seguente viene illustrato come l'oggetto CompareInfo associato a un CultureInfo oggetto influisce sul confronto tra stringhe.

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

Commenti

Per altre informazioni su questa API, vedere Osservazioni aggiuntive sull'API per CompareInfo.

Proprietà

LCID	Ottiene l'identificatore di impostazioni cultura corretto per la classe CompareInfo corrente.
Name	Ottiene il nome delle impostazioni cultura usate per le operazioni di ordinamento dall'oggetto CompareInfo corrente.
Version	Ottiene le informazioni sulla versione Unicode usata per il confronto e l'ordinamento delle stringhe.

Metodi

Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Confronta due intervalli di caratteri di sola lettura.
Compare(String, Int32, Int32, String, Int32, Int32)	Confronta due sezioni di due stringhe.
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)	Confronta due sezioni di due stringhe usando il valore CompareOptions specificato.
Compare(String, Int32, String, Int32)	Confronta le sezioni finali di due stringhe.
Compare(String, Int32, String, Int32, CompareOptions)	Confronta le sezioni finali di due stringhe usando il valore CompareOptions specificato.
Compare(String, String)	Confronta due stringhe.
Compare(String, String, CompareOptions)	Confronta due stringhe usando il valore CompareOptions specificato.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto CompareInfo corrente.
GetCompareInfo(Int32)	Inizializza un nuovo oggetto CompareInfo associato alle impostazioni cultura con l'identificatore specificato.
GetCompareInfo(Int32, Assembly)	Inizializza un nuovo oggetto CompareInfo associato alle impostazioni cultura specificate e che usa i metodi di confronto tra stringhe nell'oggetto Assembly specificato.
GetCompareInfo(String)	Inizializza un nuovo oggetto CompareInfo associato alle impostazioni cultura con il nome specificato.
GetCompareInfo(String, Assembly)	Inizializza un nuovo oggetto CompareInfo associato alle impostazioni cultura specificate e che usa i metodi di confronto tra stringhe nell'oggetto Assembly specificato.
GetHashCode()	Viene usato come funzione hash per l'oggetto CompareInfo corrente per algoritmi hash e strutture di dati, ad esempio una tabella hash.
GetHashCode(ReadOnlySpan<Char>, CompareOptions)	Ottiene il codice hash per un intervallo di caratteri in base alle opzioni di confronto specificate.
GetHashCode(String, CompareOptions)	Ottiene il codice hash per una stringa basata sulle opzioni di confronto specificate.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)	Calcola una chiave di ordinamento per l'input specificato.
GetSortKey(String)	Ottiene la chiave di ordinamento per la stringa specificata.
GetSortKey(String, CompareOptions)	Ottiene un oggetto SortKey per la stringa specificata usando il valore CompareOptions specificato.
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)	Ottiene il numero totale di byte della chiave di ordinamento che verrebbero prodotti dall'input specificato.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Cerca la prima occorrenza di una sottostringa all'interno dell'intervallo di caratteri di sola lettura specificato.
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Cerca la prima occorrenza di una sottostringa all'interno di una stringa di origine.
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Cerca la prima occorrenza di un Rune oggetto all'interno dell'intervallo di caratteri di sola lettura specificato.
IndexOf(String, Char)	Cerca il carattere specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intera stringa di origine.
IndexOf(String, Char, CompareOptions)	Cerca il carattere specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intera stringa di origine usando il valore CompareOptions.
IndexOf(String, Char, Int32)	Cerca il carattere specificato e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine compresa tra l'indice specificato e la fine della stringa.
IndexOf(String, Char, Int32, CompareOptions)	Cerca il carattere specificato e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine che si estende dall'indice specificato alla fine della stringa usando il valore CompareOptions specificato.
IndexOf(String, Char, Int32, Int32)	Cerca il carattere specificato e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine che inizia dall'indice specificato e contiene il numero specificato di elementi.
IndexOf(String, Char, Int32, Int32, CompareOptions)	Cerca il carattere specificato e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine, che inizia dall'indice specificato e contiene il numero specificato di elementi, usando il valore CompareOptions specificato.
IndexOf(String, String)	Cerca la sottostringa specificata e restituisce l'indice in base zero della prima occorrenza all'interno dell'intera stringa di origine.
IndexOf(String, String, CompareOptions)	Cerca la sottostringa specificata e restituisce l'indice in base zero della prima occorrenza all'interno dell'intera stringa di origine usando il valore CompareOptions specificato.
IndexOf(String, String, Int32)	Cerca la sottostringa specificata e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine compresa tra l'indice specificato e la fine della stringa.
IndexOf(String, String, Int32, CompareOptions)	Cerca la sottostringa specificata e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine compresa tra l'indice specificato e la fine della stringa, usando il valore CompareOptions specificato.
IndexOf(String, String, Int32, Int32)	Cerca la sottostringa specificata e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine che inizia dall'indice specificato e contiene il numero specificato di elementi.
IndexOf(String, String, Int32, Int32, CompareOptions)	Cerca la sottostringa specificata e restituisce l'indice in base zero della prima occorrenza all'interno della sezione della stringa di origine, che inizia dall'indice specificato e contiene il numero specificato di elementi, usando il valore CompareOptions.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se un intervallo di caratteri di sola lettura inizia con un prefisso specifico.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se una stringa inizia con un prefisso specifico.
IsPrefix(String, String)	Determina se la stringa di origine specificata inizia con il prefisso specificato.
IsPrefix(String, String, CompareOptions)	Determina se la stringa di origine specificata inizia con il prefisso specificato usando il valore CompareOptions specificato.
IsSortable(Char)	Indica se un carattere Unicode specificato è ordinabile.
IsSortable(ReadOnlySpan<Char>)	Indica se un intervallo di caratteri di sola lettura Unicode specificato è ordinabile.
IsSortable(Rune)	Indica se un oggetto Rune specificato è ordinabile.
IsSortable(String)	Indica se una stringa Unicode specificata è ordinabile.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se un intervallo di caratteri di sola lettura termina con un suffisso specifico.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se una stringa termina con un suffisso specifico.
IsSuffix(String, String)	Determina se la stringa di origine specificata termina con il suffisso specificato.
IsSuffix(String, String, CompareOptions)	Determina se la stringa di origine specificata termina con il suffisso specificato usando il valore CompareOptions specificato.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Cerca l'ultima occorrenza di una sottostringa all'interno dell'intervallo di caratteri di sola lettura specificato.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Cerca l'ultima occorrenza di una sottostringa all'interno di una stringa di origine.
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Cerca l'ultima occorrenza di un oggetto Rune all'interno dell'intervallo di caratteri di sola lettura specificato.
LastIndexOf(String, Char)	Cerca il carattere specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'intera stringa di origine.
LastIndexOf(String, Char, CompareOptions)	Cerca il carattere specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'intera stringa di origine usando il valore CompareOptions specificato.
LastIndexOf(String, Char, Int32)	Cerca il carattere specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno della sezione della stringa di origine compresa tra l'inizio della stringa e l'indice specificato.
LastIndexOf(String, Char, Int32, CompareOptions)	Cerca il carattere specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno della sezione della stringa di origine compresa tra l'inizio della stringa e l'indice specificato, usando il valore CompareOptions specificato.
LastIndexOf(String, Char, Int32, Int32)	Cerca il carattere specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno della sezione della stringa di origine che contiene il numero specificato di elementi e termina in corrispondenza dell'indice specificato.
LastIndexOf(String, Char, Int32, Int32, CompareOptions)	Cerca il carattere specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno della sezione della stringa di origine che contiene il numero specificato di elementi e termina in corrispondenza dell'indice specificato, usando il valore CompareOptions specificato.
LastIndexOf(String, String)	Cerca la sottostringa specificata e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'intera stringa di origine.
LastIndexOf(String, String, CompareOptions)	Cerca la sottostringa specificata e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'intera stringa di origine usando il valore CompareOptions specificato.
LastIndexOf(String, String, Int32)	Cerca la sottostringa specificata e restituisce l'indice in base zero dell'ultima occorrenza all'interno della sezione della stringa di origine compresa tra l'inizio della stringa e l'indice specificato.
LastIndexOf(String, String, Int32, CompareOptions)	Cerca la sottostringa specificata e restituisce l'indice in base zero dell'ultima occorrenza nella sezione della stringa di origine compresa tra l'inizio della stringa e l'indice specificato, usando il valore CompareOptions specificato.
LastIndexOf(String, String, Int32, Int32)	Cerca la sottostringa specificata e restituisce l'indice in base zero dell'ultima occorrenza all'interno della sezione della stringa di origine che contiene il numero specificato di elementi e termina in corrispondenza dell'indice specificato.
LastIndexOf(String, String, Int32, Int32, CompareOptions)	Cerca la sottostringa specificata e restituisce l'indice in base zero dell'ultima occorrenza all'interno della sezione della stringa di origine che contiene il numero specificato di elementi e termina in corrispondenza dell'indice specificato, usando il valore CompareOptions specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto CompareInfo corrente.

Implementazioni dell'interfaccia esplicita

IDeserializationCallback.OnDeserialization(Object)

Viene eseguito dopo la deserializzazione dell'intero grafico di oggetti.

Metodi di estensione

GetStringComparer(CompareInfo, CompareOptions)

Restituisce un oggetto StringComparer in base alle regole di confronto delle stringhe con distinzione delle impostazioni cultura di un oggetto CompareInfo specificato.

Vedi anche

• Ordinamento di tabelle ponderate per sistemi operativi Windows
• Tabella degli elementi delle regole di confronto Unicode predefinita, per Linux e macOS