SortVersion Classe

Définition

Espace de noms:

System.Globalization

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

SortVersion.cs

Fournit des informations sur la version d’Unicode utilisée pour comparer et classer des chaînes.

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

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

type SortVersion = class
    interface IEquatable<SortVersion>

Public NotInheritable Class SortVersion
Implements IEquatable(Of SortVersion)

Héritage

Object

SortVersion

Implémente

IEquatable<SortVersion>

Remarques

Comparaison de chaînes et de tri

Toutes les versions de .NET (Core) reposent sur le système d’exploitation sous-jacent lors de l’exécution de comparaisons de chaînes. Par conséquent, les résultats d’une comparaison de chaînes ou de l’ordre dans lequel les chaînes sont triées dépendent de la version d’Unicode utilisée par le système d’exploitation lors de l’exécution de la comparaison. Sur Linux, macOS et Windows 10 et versions ultérieures, les composants internationaux pour les bibliothèques Unicode fournissent l’implémentation pour la comparaison et le tri des API.

Utiliser la classe SortVersion

La SortVersion classe fournit des informations sur la version Unicode utilisée par .NET pour la comparaison de chaînes et l’ordre. Il permet aux développeurs d’écrire des applications capables de détecter et de gérer correctement les modifications dans la version d’Unicode utilisée pour comparer et trier les chaînes d’une application.

Vous pouvez instancier un SortVersion objet de deux façons :

• En appelant le constructeur SortVersion, qui instancie un nouvel objet SortVersion en fonction d’un numéro de version et d’un ID de tri. Ce constructeur est le plus utile lors de la recréation d’un SortVersion objet à partir de données enregistrées.
• En extrayant la valeur de la propriété CompareInfo.Version. Cette propriété fournit des informations sur la version Unicode utilisée par l’implémentation .NET sur laquelle l’application s’exécute.

La SortVersion classe a deux propriétés et FullVersionSortId, qui indiquent la version Unicode et la culture spécifique utilisée pour la comparaison de chaînes. La FullVersion propriété est une valeur numérique arbitraire qui reflète la version Unicode utilisée pour la comparaison de chaînes, et la SortId propriété est arbitraire Guid qui reflète la culture dont les conventions sont utilisées pour la comparaison de chaînes. Les valeurs de ces deux propriétés sont importantes uniquement lorsque vous comparez deux SortVersion objets à l’aide de la Equals méthode, de l’opérateur Equality ou de l’opérateur Inequality .

Vous utilisez généralement un objet SortVersion lors de l'enregistrement ou de la récupération de données de chaîne structurées et sensibles à la culture, telles que des index ou des chaînes littérales. Cela nécessite les étapes suivantes :

1. Lorsque les données de chaîne ordonnées sont enregistrées, les valeurs de propriété FullVersion et SortId sont également enregistrées.

2. Lorsque les données de chaîne ordonnées sont récupérées, vous pouvez recréer l’objet SortVersion utilisé pour classer les chaînes en appelant le SortVersion constructeur.

3. Cet objet nouvellement instancié SortVersion est comparé à un SortVersion objet qui reflète la culture dont les conventions sont utilisées pour classer les données de chaîne.

4. Si les deux SortVersion objets ne sont pas égaux, les données de chaîne doivent être réorganisées.

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":::

Constructeurs

Nom	Description
SortVersion(Int32, Guid)	Crée une instance de la SortVersion classe.

Propriétés

Nom	Description
FullVersion	Obtient le numéro de version complet de l’objet SortVersion .
SortId	Obtient un identificateur global unique pour cet SortVersion objet.

Méthodes

Nom	Description
Equals(Object)	Retourne une valeur qui indique si cette SortVersion instance est égale à un objet spécifié.
Equals(SortVersion)	Retourne une valeur qui indique si cette SortVersion instance est égale à un objet spécifié SortVersion .
GetHashCode()	Retourne un code de hachage pour cette instance.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Opérateurs

Nom	Description
Equality(SortVersion, SortVersion)	Indique si deux SortVersion instances sont égales.
Inequality(SortVersion, SortVersion)	Indique si deux SortVersion instances ne sont pas égales.

Voir aussi

• Version