SortVersion Classe

Definizione

public ref class SortVersion sealed : IEquatable<System::Globalization::SortVersion ^>

public sealed class SortVersion : IEquatable<System.Globalization.SortVersion>

[System.Serializable]
public sealed class SortVersion : IEquatable<System.Globalization.SortVersion>

type SortVersion = class
    interface IEquatable<SortVersion>

[<System.Serializable>]
type SortVersion = class
    interface IEquatable<SortVersion>

Public NotInheritable Class SortVersion
Implements IEquatable(Of SortVersion)

Ereditarietà

Object

SortVersion

Attributi

SerializableAttribute

Implementazioni

IEquatable<SortVersion>

Commenti

Ordinamento e confronto tra stringhe

Tutte le versioni di .NET (Core) si basano sul sistema operativo sottostante durante l'esecuzione di confronti tra stringhe. Pertanto, i risultati di un confronto di stringhe o l'ordine in cui le stringhe vengono ordinate dipende dalla versione di Unicode usata dal sistema operativo durante l'esecuzione del confronto. In Linux, macOS e Windows 10 e versioni successive, i componenti internazionali per le librerie Unicode forniscono l'implementazione per le API di confronto e ordinamento.

Usare la classe SortVersion

La SortVersion classe fornisce informazioni sulla versione Unicode usata da .NET per il confronto e l'ordinamento delle stringhe. Consente agli sviluppatori di scrivere applicazioni in grado di rilevare e gestire correttamente le modifiche nella versione di Unicode usata per confrontare e ordinare le stringhe di un'applicazione.

È possibile istanziare un oggetto SortVersion in due modi:

• Chiamando il SortVersion costruttore, che crea un'istanza di un nuovo SortVersion oggetto in base a un numero di versione e a un ID di ordinamento. Questo costruttore è più utile quando si ricrea un SortVersion oggetto dai dati salvati.
• Recuperando il valore della CompareInfo.Version proprietà. Questa proprietà fornisce informazioni sulla versione Unicode usata dall'implementazione .NET in cui è in esecuzione l'applicazione.

La SortVersion classe ha due proprietà, FullVersion e SortId, che indicano la versione Unicode e le impostazioni cultura specifiche usate per il confronto tra stringhe. La FullVersion proprietà è un valore numerico arbitrario che riflette la versione Unicode usata per il confronto tra stringhe e la SortId proprietà è un arbitrario Guid che riflette le impostazioni cultura le cui convenzioni vengono utilizzate per il confronto tra stringhe. I valori di queste due proprietà sono importanti solo quando si confrontano due SortVersion oggetti usando il Equals metodo , l'operatore Equality o l'operatore Inequality .

In genere si utilizza un SortVersion oggetto quando si salvano o si recuperano dati stringa ordinati e sensibili alla cultura, come indici o le stesse stringhe letterali. Questa operazione richiede i passaggi seguenti:

1. Quando vengono salvati i dati della stringa ordinata, vengono salvati anche i valori delle FullVersion proprietà e SortId .

2. Quando vengono recuperati i dati di stringa ordinati, è possibile ricreare l'oggetto SortVersion usato per ordinare le stringhe chiamando il SortVersion costruttore .

3. Questo oggetto appena istanziato SortVersion viene confrontato con un SortVersion oggetto che riflette le impostazioni culturali le cui convenzioni vengono utilizzate per ordinare i dati di stringa.

4. Se i due SortVersion oggetti non sono uguali, i dati stringa devono essere riordinati.

Example

  The following example contains a portion of the source code from an application that uses the <xref:System.Globalization.SortVersion> class to ensure that the native names of <xref:System.Globalization.RegionInfo> objects are ordered appropriately for the current system and current culture. It uses the <xref:System.IO.BinaryReader> and <xref:System.IO.BinaryWriter> objects to store and retrieve ordered data from a data file named `Regions.dat` rather than retrieving and ordering data each time the application is run. The example first checks to determine whether the data file exists. If it does not, it creates the data and sets the `reindex` flag, which indicates that the data must be resorted and saved again. Otherwise, it retrieves the data and compares the saved <xref:System.Globalization.SortVersion> object with the <xref:System.Globalization.SortVersion> object for the current culture on the current system. If they aren't equal, or if the `reindex` flag had been set previously, it resorts to the <xref:System.Globalization.RegionInfo> data.

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

Vedi anche

• Version