SortVersion Kelas

Definisi

Ruang nama:
System.Globalization
Rakitan:
netstandard.dll, System.Runtime.dll
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll
Sumber:
SortVersion.cs
Sumber:
SortVersion.cs
Sumber:
SortVersion.cs
Sumber:
SortVersion.cs
Sumber:
SortVersion.cs

Menyediakan informasi tentang versi Unicode yang digunakan untuk membandingkan dan mengurutkan string.

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)
Warisan
Object
SortVersion
Atribut
SerializableAttribute
Penerapan
IEquatable<SortVersion>

Keterangan

Perbandingan pengurutan dan string

Semua versi .NET (Core) mengandalkan sistem operasi yang mendasarinya saat melakukan perbandingan string. Oleh karena itu, hasil perbandingan string atau urutan di mana string diurutkan tergantung pada versi Unicode yang digunakan oleh sistem operasi saat melakukan perbandingan. Di Linux, macOS, dan Windows 10 dan versi yang lebih baru, Komponen Internasional untuk pustaka Unicode menyediakan implementasi untuk perbandingan dan pengurutan API.

Menggunakan kelas SortVersion

Kelas ini SortVersion menyediakan informasi tentang versi Unicode yang digunakan oleh .NET untuk perbandingan dan pengurutan string. Ini memungkinkan pengembang untuk menulis aplikasi yang dapat mendeteksi dan berhasil menangani perubahan dalam versi Unicode yang digunakan untuk membandingkan dan mengurutkan string aplikasi.

Anda dapat menginstansiasi objek SortVersion dengan dua cara:

  • Dengan memanggil konstruktor SortVersion, yang menginisialisasi objek baru SortVersion menurut nomor versi dan ID pengurutan. Konstruktor ini paling berguna saat membuat ulang objek dari data yang SortVersion disimpan.
  • Dengan mengambil nilai properti CompareInfo.Version. Properti ini menyediakan informasi tentang versi Unicode yang digunakan oleh implementasi .NET tempat aplikasi berjalan.

Kelas SortVersion ini memiliki dua properti, FullVersion dan SortId, yang menunjukkan versi Unicode dan budaya spesifik yang digunakan untuk perbandingan string. Properti FullVersion adalah nilai numerik arbitrer yang mencerminkan versi Unicode yang digunakan untuk perbandingan string, dan SortId properti adalah arbitrer Guid yang mencerminkan budaya yang konvensinya digunakan untuk perbandingan string. Nilai kedua properti ini hanya penting ketika Anda membandingkan dua SortVersion objek dengan menggunakan Equals metode , Equality operator , atau Inequality operator .

Anda biasanya menggunakan objek SortVersion saat menyimpan atau mengambil beberapa bentuk data string yang sensitif terhadap budaya dan terurut, seperti indeks atau teks literal. Ini memerlukan langkah-langkah berikut:

  1. Saat data string yang diurutkan disimpan, nilai properti FullVersion dan SortId juga disimpan.

  2. Saat data string yang diurutkan diambil, Anda dapat membuat ulang objek yang digunakan untuk mengurutkan string SortVersion dengan memanggil konstruktor SortVersion.

  3. Objek SortVersion yang baru diinstansiasi ini dibandingkan dengan objek SortVersion yang mencerminkan budaya yang konvensinya digunakan untuk mengurutkan data string.

  4. Jika dua SortVersion objek tidak sama, data string harus diurutkan ulang.

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

Konstruktor

Nama Deskripsi
SortVersion(Int32, Guid)

Membuat instans SortVersion baru kelas.

Properti

Nama Deskripsi
FullVersion

Mendapatkan nomor SortVersion versi lengkap objek.
SortId

Mendapatkan pengidentifikasi unik global untuk objek ini SortVersion .

Metode

Nama Deskripsi
Equals(Object)

Mengembalikan nilai yang menunjukkan apakah instans ini SortVersion sama dengan objek tertentu.
Equals(SortVersion)

Mengembalikan nilai yang menunjukkan apakah instans ini SortVersion sama dengan objek tertentu SortVersion .
GetHashCode()

Mengembalikan kode hash untuk instans ini.
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Operator

Nama Deskripsi
Equality(SortVersion, SortVersion)

Menunjukkan apakah dua SortVersion instans sama.
Inequality(SortVersion, SortVersion)

Menunjukkan apakah dua SortVersion instans tidak sama.

Berlaku untuk

Lihat juga