SortVersion Klasse

Definition

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)

Vererbung

Object

SortVersion

Attribute

SerializableAttribute

Implementiert

IEquatable<SortVersion>

Hinweise

Sortieren und Zeichenfolgenvergleich

Alle Versionen von .NET (Core) basieren beim Ausführen von Zeichenfolgenvergleichen auf dem zugrunde liegenden Betriebssystem. Daher sind die Ergebnisse eines Zeichenfolgenvergleichs oder der Reihenfolge, in der Zeichenfolgen sortiert werden, von der Version von Unicode abhängig, die vom Betriebssystem beim Ausführen des Vergleichs verwendet wird. Unter Linux, macOS und Windows 10 und höher bieten internationale Komponenten für Unicode-Bibliotheken die Implementierung für Vergleichs- und Sortier-APIs.

Verwenden der SortVersion-Klasse

Die SortVersion Klasse enthält Informationen zur Unicode-Version, die von .NET für den Zeichenfolgenvergleich und die Sortierung verwendet wird. Es ermöglicht Entwicklern das Schreiben von Anwendungen, die Änderungen in der Unicode-Version erkennen und erfolgreich verarbeiten können, die zum Vergleichen und Sortieren der Zeichenfolgen einer Anwendung verwendet wird.

Sie können ein SortVersion Objekt auf zwei Arten instanziieren:

• Durch Aufrufen des SortVersion Konstruktors wird ein neues SortVersion Objekt instanziiert, basierend auf einer Versionsnummer und einer Sortier-Identifikationsnummer. Dieser Konstruktor ist am nützlichsten, wenn ein SortVersion Objekt aus gespeicherten Daten neu erstellt wird.
• Durch Abrufen des Werts der CompareInfo.Version-Eigenschaft. Diese Eigenschaft enthält Informationen zur Unicode-Version, die von der .NET-Implementierung verwendet wird, auf der die Anwendung ausgeführt wird.

Die SortVersion Klasse weist zwei Eigenschaften auf, FullVersion und SortId, die die Unicode-Version und die spezifische Kultur angeben, die für den Zeichenfolgenvergleich verwendet wird. Die FullVersion Eigenschaft ist ein beliebiger numerischer Wert, der die für den Zeichenfolgenvergleich verwendete Unicode-Version widerspiegelt, und die SortId Eigenschaft ist ein beliebiger Guid Wert, der die Kultur widerspiegelt, deren Konventionen für den Zeichenfolgenvergleich verwendet werden. Die Werte dieser beiden Eigenschaften sind nur dann wichtig, wenn Sie zwei SortVersion Objekte mithilfe der Equals Methode, des Equality Operators oder des Inequality Operators vergleichen.

Normalerweise verwenden Sie ein SortVersion Objekt beim Speichern oder Abrufen einer Form von kulturempfindlichen, sortierten Zeichenfolgendaten, z. B. Indizes oder die Literalzeichenfolgen selbst. Dies erfordert die folgenden Schritte:

1. Wenn die sortierten Zeichenfolgendaten gespeichert werden, werden auch die Werte der Eigenschaften FullVersion und SortId gespeichert.

2. Wenn die sortierten Zeichenfolgendaten abgerufen werden, können Sie das SortVersion-Objekt neu erstellen, das zum Sortieren der Zeichenfolgen verwendet wird, indem Sie den SortVersion-Konstruktor aufrufen.

3. Dieses neu instanziierte SortVersion Objekt wird mit einem SortVersion Objekt verglichen, das die Kultur widerspiegelt, deren Konventionen verwendet werden, um die Zeichenfolgendaten zu ordnen.

4. Wenn die beiden SortVersion Objekte nicht gleich sind, müssen die Zeichenfolgendaten neu angeordnet werden.

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

Weitere Informationen

• Version