CompareInfo Kelas

Definisi

Ruang nama:

System.Globalization

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

CompareInfo.cs

Menerapkan serangkaian metode untuk perbandingan string yang sensitif terhadap budaya.

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

Warisan

Object

CompareInfo

Penerapan

IDeserializationCallback

Keterangan

Konvensi untuk membandingkan dan mengurutkan data bervariasi dari budaya ke budaya. Misalnya, urutan pengurutan mungkin didasarkan pada fonetik atau pada representasi visual karakter. Dalam bahasa Asia Timur, karakter diurutkan berdasarkan goresan dan radikal ideograf. Pengurutan juga tergantung pada urutan yang digunakan oleh bahasa dan budaya untuk alfabet. Misalnya, bahasa Denmark memiliki karakter "Æ" yang diurutkannya setelah "Z" dalam alfabet. Selain itu, perbandingan mungkin sensitif atau tidak sensitif terhadap penggunaan huruf besar dan kecil, dan aturan penulisan ini juga dapat berbeda menurut budaya. Kelas CompareInfo ini bertanggung jawab untuk mempertahankan data perbandingan string sensitif budaya ini dan untuk melakukan operasi string yang sensitif terhadap budaya.

Biasanya, Anda tidak perlu membuat instans objek CompareInfo secara langsung, karena objek ini digunakan secara implisit oleh semua operasi perbandingan string non-ordinal, termasuk panggilan ke metode String.Compare. Namun, jika Anda ingin mengambil CompareInfo objek, Anda dapat melakukannya dengan salah satu cara berikut:

• Dengan mengambil nilai properti CultureInfo.CompareInfo untuk kebudayaan tertentu.

• Dengan memanggil metode statis GetCompareInfo dengan nama budaya. Ini memungkinkan akses terikat terlambat ke CompareInfo objek.

Nilai pencarian yang diabaikan

Set karakter termasuk karakter yang dapat diabaikan, yaitu karakter yang tidak dipertimbangkan saat melakukan perbandingan yang bersifat linguistik atau sensitif terhadap budaya. Metode perbandingan seperti IndexOf dan LastIndexOf tidak mempertimbangkan karakter tersebut ketika mereka melakukan perbandingan yang sensitif terhadap budaya. Karakter yang dapat diabaikan meliputi:

• String.Empty. Metode perbandingan yang sensitif terhadap budaya akan selalu menemukan string kosong di awal (indeks nol) dari string yang sedang dicari.

• Karakter atau string yang terdiri dari karakter dengan titik kode yang tidak dipertimbangkan dalam operasi karena opsi perbandingan. Khususnya, opsi CompareOptions.IgnoreNonSpace dan CompareOptions.IgnoreSymbols menghasilkan pencarian di mana simbol dan karakter penggabung tanpa spasi diabaikan.

• String dengan titik kode yang tidak memiliki signifikansi linguistik. Misalnya, tanda hubung lunak (U+00AD) selalu diabaikan dalam perbandingan string berdasarkan budaya.

Pertimbangan keamanan

Jika keputusan keamanan tergantung pada perbandingan string atau perubahan kasus, Anda harus menggunakan InvariantCulture properti untuk memastikan bahwa perilaku tersebut konsisten, terlepas dari pengaturan budaya sistem operasi.

Note

Jika memungkinkan, Anda harus menggunakan metode perbandingan string yang memiliki parameter jenis CompareOptions untuk menentukan jenis perbandingan yang diharapkan. Sebagai aturan umum, gunakan opsi linguistik (menggunakan budaya saat ini) untuk membandingkan string yang ditampilkan di antarmuka pengguna dan tentukan Ordinal atau OrdinalIgnoreCase untuk perbandingan keamanan.

Example

  The following example shows how the <xref:System.Globalization.CompareInfo> object associated with a <xref:System.Globalization.CultureInfo> object affects string comparison.

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

Properti

Nama	Deskripsi
LCID	Mendapatkan pengidentifikasi budaya yang terbentuk dengan benar untuk saat ini CompareInfo.
Name	Mendapatkan nama budaya yang digunakan untuk mengurutkan operasi menurut objek ini CompareInfo .
Version	Mendapatkan informasi tentang versi Unicode yang digunakan untuk membandingkan dan mengurutkan string.

Metode

Nama	Deskripsi
Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Membandingkan dua rentang karakter baca-saja.
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)	Membandingkan bagian dari satu string dengan bagian dari string lain menggunakan nilai yang ditentukan CompareOptions .
Compare(String, Int32, Int32, String, Int32, Int32)	Membandingkan bagian dari satu string dengan bagian dari string lain.
Compare(String, Int32, String, Int32, CompareOptions)	Membandingkan bagian akhir string dengan bagian akhir string lain menggunakan nilai yang ditentukan CompareOptions .
Compare(String, Int32, String, Int32)	Membandingkan bagian akhir string dengan bagian akhir string lain.
Compare(String, String, CompareOptions)	Membandingkan dua string menggunakan nilai yang ditentukan CompareOptions .
Compare(String, String)	Membandingkan dua string.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini CompareInfo .
GetCompareInfo(Int32, Assembly)	Menginisialisasi objek baru CompareInfo yang terkait dengan budaya yang ditentukan dan yang menggunakan metode perbandingan string dalam yang ditentukan Assembly.
GetCompareInfo(Int32)	Menginisialisasi objek baru CompareInfo yang terkait dengan budaya dengan pengidentifikasi yang ditentukan.
GetCompareInfo(String, Assembly)	Menginisialisasi objek baru CompareInfo yang terkait dengan budaya yang ditentukan dan yang menggunakan metode perbandingan string dalam yang ditentukan Assembly.
GetCompareInfo(String)	Menginisialisasi objek baru CompareInfo yang terkait dengan budaya dengan nama yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash untuk saat ini CompareInfo untuk algoritma hashing dan struktur data, seperti tabel hash.
GetHashCode(ReadOnlySpan<Char>, CompareOptions)	Mendapatkan kode hash untuk rentang karakter berdasarkan opsi perbandingan yang ditentukan.
GetHashCode(String, CompareOptions)	Mendapatkan kode hash untuk string berdasarkan opsi perbandingan yang ditentukan.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)	Menghitung kunci pengurutan untuk input yang ditentukan.
GetSortKey(String, CompareOptions)	SortKey Mendapatkan objek untuk string yang ditentukan menggunakan nilai yang ditentukanCompareOptions.
GetSortKey(String)	Mendapatkan kunci pengurutan untuk string yang ditentukan.
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)	Mendapatkan jumlah total byte kunci sortir yang akan dihasilkan dari input yang ditentukan.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Mencari kemunculan pertama substring dalam string sumber.
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Mencari kemunculan pertama substring dalam rentang karakter baca-saja yang ditentukan.
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Mencari kemunculan pertama karakter Rune dalam rentang karakter baca-saja yang ditentukan.
IndexOf(String, Char, CompareOptions)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh string sumber menggunakan nilai yang ditentukan CompareOptions .
IndexOf(String, Char, Int32, CompareOptions)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam bagian string sumber yang meluas dari indeks yang ditentukan ke akhir string menggunakan nilai yang ditentukan CompareOptions .
IndexOf(String, Char, Int32, Int32, CompareOptions)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama di dalam bagian string sumber yang dimulai pada indeks yang ditentukan dan berisi jumlah elemen yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
IndexOf(String, Char, Int32, Int32)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama di dalam bagian string sumber yang dimulai pada indeks yang ditentukan dan berisi jumlah elemen yang ditentukan.
IndexOf(String, Char, Int32)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam bagian string sumber yang meluas dari indeks yang ditentukan ke akhir string.
IndexOf(String, Char)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh string sumber.
IndexOf(String, String, CompareOptions)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh string sumber menggunakan nilai yang ditentukan CompareOptions .
IndexOf(String, String, Int32, CompareOptions)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama di dalam bagian string sumber yang meluas dari indeks yang ditentukan ke akhir string menggunakan nilai yang ditentukan CompareOptions .
IndexOf(String, String, Int32, Int32, CompareOptions)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam bagian string sumber yang dimulai pada indeks yang ditentukan dan berisi jumlah elemen yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
IndexOf(String, String, Int32, Int32)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama di dalam bagian string sumber yang dimulai pada indeks yang ditentukan dan berisi jumlah elemen yang ditentukan.
IndexOf(String, String, Int32)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam bagian string sumber yang meluas dari indeks yang ditentukan ke akhir string.
IndexOf(String, String)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh string sumber.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Menentukan apakah string dimulai dengan awalan tertentu.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Menentukan apakah rentang karakter baca-saja dimulai dengan awalan tertentu.
IsPrefix(String, String, CompareOptions)	Menentukan apakah string sumber yang ditentukan dimulai dengan awalan yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
IsPrefix(String, String)	Menentukan apakah string sumber yang ditentukan dimulai dengan awalan yang ditentukan.
IsSortable(Char)	Menunjukkan apakah karakter Unicode tertentu dapat diurutkan.
IsSortable(ReadOnlySpan<Char>)	Menunjukkan apakah rentang karakter baca-saja Unicode tertentu dapat diurutkan.
IsSortable(Rune)	Menunjukkan apakah yang ditentukan Rune dapat diurutkan.
IsSortable(String)	Menunjukkan apakah string Unicode tertentu dapat diurutkan.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Menentukan apakah string diakhiri dengan akhiran tertentu.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Menentukan apakah rentang karakter baca-saja diakhiri dengan akhiran tertentu.
IsSuffix(String, String, CompareOptions)	Menentukan apakah string sumber yang ditentukan diakhiri dengan akhiran yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
IsSuffix(String, String)	Menentukan apakah string sumber yang ditentukan diakhiri dengan akhiran yang ditentukan.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Mencari kemunculan terakhir substring dalam string sumber.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Mencari kemunculan terakhir substring dalam rentang karakter baca-saja yang ditentukan.
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Mencari kemunculan terakhir dari dalam Rune rentang karakter baca-saja yang ditentukan.
LastIndexOf(String, Char, CompareOptions)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir dalam seluruh string sumber menggunakan nilai yang ditentukan CompareOptions .
LastIndexOf(String, Char, Int32, CompareOptions)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang meluas dari awal string ke indeks yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
LastIndexOf(String, Char, Int32, Int32, CompareOptions)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang berisi jumlah elemen yang ditentukan dan berakhir pada indeks yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
LastIndexOf(String, Char, Int32, Int32)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang berisi jumlah elemen yang ditentukan dan berakhir pada indeks yang ditentukan.
LastIndexOf(String, Char, Int32)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang meluas dari awal string ke indeks yang ditentukan.
LastIndexOf(String, Char)	Mencari karakter yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir dalam seluruh string sumber.
LastIndexOf(String, String, CompareOptions)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir dalam seluruh string sumber menggunakan nilai yang ditentukan CompareOptions .
LastIndexOf(String, String, Int32, CompareOptions)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang meluas dari awal string ke indeks yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
LastIndexOf(String, String, Int32, Int32, CompareOptions)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang berisi jumlah elemen dan berakhir pada indeks yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
LastIndexOf(String, String, Int32, Int32)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang berisi jumlah elemen yang ditentukan dan berakhir pada indeks yang ditentukan.
LastIndexOf(String, String, Int32)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir di dalam bagian string sumber yang meluas dari awal string ke indeks yang ditentukan.
LastIndexOf(String, String)	Mencari substring yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir dalam seluruh string sumber.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini CompareInfo .

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IDeserializationCallback.OnDeserialization(Object)	Berjalan ketika seluruh grafik objek telah dideserialisasi.

Metode Ekstensi

Nama	Deskripsi
GetStringComparer(CompareInfo, CompareOptions)	Mengembalikan StringComparer objek berdasarkan aturan perbandingan CompareInfo string sensitif budaya dari objek tertentu.

Lihat juga

• Mengurutkan Tabel Berat untuk sistem operasi Windows
• Tabel Elemen Kolas Unicode Default, untuk Linux dan macOS