CompareInfo Osztály

Definíció

Névtér:

System.Globalization

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

CompareInfo.cs

A kultúra szempontjából érzékeny sztring-összehasonlítások metódusainak egy készletét implementálja.

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

Öröklődés

Object

CompareInfo

Megvalósítás

IDeserializationCallback

Megjegyzések

Az adatok összehasonlítására és rendezésére vonatkozó konvenciók kultúránként eltérőek. A rendezési sorrend például a fonetika vagy a karakterek vizuális ábrázolása alapján történhet. A kelet-ázsiai nyelvekben a karaktereket az ideográfiák vonalai és gyöke rendezi. A rendezés attól is függ, hogy a nyelvek és a kultúrák milyen sorrendben használják az ábécét. A dán nyelv például egy "Æ" karaktert tartalmaz, amelyet az ábécé "Z" betűje után rendez. Emellett az összehasonlítások lehetnek kis- és nagybetű-érzékenyek, vagy éppen érzéketlenek, és a kis- és nagybetű-használati szabályok kultúránként is eltérhetnek. Az CompareInfo osztály feladata a kultúraérzékeny sztringek összehasonlító adatainak karbantartása és a kultúraérzékeny sztringműveletek végrehajtása.

Általában nem kell közvetlenül példányosítania egy CompareInfo objektumot, mert az objektumot implicit módon használja az összes nem sorszámú sztring-összehasonlító művelet, beleértve a String.Compare metódus hívásait is. Ha azonban le szeretne kérni egy CompareInfo objektumot, az alábbi módokon teheti meg:

• Egy adott kultúrához tartozó CultureInfo.CompareInfo tulajdonság értékének lekérése által.

• A statikus GetCompareInfo metódus kulturális névvel való meghívásával. Ez lehetővé teszi egy CompareInfo objektumhoz történő késői hozzáférést.

Figyelmen kívül hagyott keresési értékek

A karakterkészletek figyelmen kívül hagyható karaktereket tartalmaznak, amelyek nyelvi vagy kulturális szempontból érzékeny összehasonlítások során nem figyelembe vett karakterek. Az olyan összehasonlító módszerek, mint például IndexOf és LastIndexOf, nem veszik figyelembe az ilyen karaktereket, amikor kultúraérzékeny összehasonlítást végeznek. A figyelmen kívül hagyható karakterek a következők:

• String.Empty. A kultúraérzékeny összehasonlító metódusok mindig egy üres sztringet találnak a keresett sztring elején (index nulla).

• Olyan karakter vagy karakterlánc, amely olyan kódpontokkal rendelkező karakterekből áll, amelyek az összehasonlítási opciók miatt nem kerülnek figyelembevételre a művelet során, különösen a CompareOptions.IgnoreNonSpace és CompareOptions.IgnoreSymbols opciók olyan kereséseket eredményeznek, amelyekben a szimbólumokat és a nem-elválasztó kombinációs karaktereket figyelmen kívül hagyják.

• Olyan kódpontokat tartalmazó sztring, amelynek nincs nyelvi jelentősége. Például egy lágy kötőjelet (U+00AD) a rendszer mindig figyelmen kívül hagy egy kultúraérzékeny karakterlánc-összehasonlítás során.

Biztonsági megfontolások

Ha egy biztonsági döntés sztring-összehasonlítástól vagy esetmódosítástól függ, a InvariantCulture tulajdonság használatával győződjön meg arról, hogy a viselkedés konzisztens, függetlenül az operációs rendszer kulturális beállításaitól.

Megjegyzés:

Ha lehetséges, olyan sztring-összehasonlító módszereket kell használnia, amelyek típusparaméterrel CompareOptions rendelkeznek a várt összehasonlítás típusának megadásához. Általános szabályként használjon nyelvi beállításokat (az aktuális kultúrát használva) a felhasználói felületen megjelenő sztringek összehasonlításához, és adja meg a Ordinal vagy OrdinalIgnoreCase lehetőséget biztonsági összehasonlításokhoz.

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

Tulajdonságok

Name	Description
LCID	Lekéri az aktuálishoz CompareInfotartozó megfelelően formázott kulturális azonosítót.
Name	Lekéri az objektum által CompareInfo végzett rendezési műveletekhez használt kultúra nevét.
Version	A karakterláncok összehasonlításához és rendezéséhez használt Unicode-verzióval kapcsolatos információk.

Metódusok

Name	Description
Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Két írásvédett karaktert hasonlít össze.
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)	Egy sztring egy szakaszát hasonlítja össze egy másik sztring egy szakaszával a megadott CompareOptions érték használatával.
Compare(String, Int32, Int32, String, Int32, Int32)	Egy sztring egy szakaszát hasonlítja össze egy másik sztring egy szakaszával.
Compare(String, Int32, String, Int32, CompareOptions)	Egy sztring záró szakaszát hasonlítja össze egy másik sztring záró szakaszával a megadott CompareOptions érték használatával.
Compare(String, Int32, String, Int32)	Egy sztring záró szakaszát hasonlítja össze egy másik sztring záró szakaszával.
Compare(String, String, CompareOptions)	Két sztringet hasonlít össze a megadott CompareOptions érték használatával.
Compare(String, String)	Két sztringet hasonlít össze.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális CompareInfo objektummal.
GetCompareInfo(Int32, Assembly)	Inicializál egy új CompareInfo objektumot, amely a megadott kultúrához van társítva, és sztring-összehasonlító metódusokat használ a megadott Assembly.
GetCompareInfo(Int32)	Inicializál egy új CompareInfo objektumot, amely a kultúrához van társítva a megadott azonosítóval.
GetCompareInfo(String, Assembly)	Inicializál egy új CompareInfo objektumot, amely a megadott kultúrához van társítva, és sztring-összehasonlító metódusokat használ a megadott Assembly.
GetCompareInfo(String)	Inicializál egy új CompareInfo objektumot, amely a kultúrához van társítva a megadott névvel.
GetHashCode()	Kivonatfüggvényként szolgál az aktuális CompareInfo kivonatoló algoritmusokhoz és adatstruktúrákhoz, például kivonattáblákhoz.
GetHashCode(ReadOnlySpan<Char>, CompareOptions)	Lekéri a karaktertartomány kivonatkódját a megadott összehasonlítási beállítások alapján.
GetHashCode(String, CompareOptions)	Lekéri egy sztring kivonatkódját a megadott összehasonlítási beállítások alapján.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)	Kiszámítja a megadott bemenet rendezési kulcsát.
GetSortKey(String, CompareOptions)	A megadott SortKey érték használatával lekéri a megadott sztring CompareOptions objektumát.
GetSortKey(String)	Lekéri a megadott sztring rendezési kulcsát.
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)	A megadott bemenetből előállított rendezési kulcs bájtjainak teljes számát adja meg.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Egy forrássztringen belüli részsztring első előfordulását keresi.
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	A megadott írásvédett karaktereken belüli részszűkítés első előfordulását keresi.
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Megkeresi a megadott írásvédett karaktertartományon belüli első előfordulást Rune .
IndexOf(String, Char, CompareOptions)	Megkeresi a megadott karaktert, és a megadott CompareOptions érték használatával visszaadja az első előfordulás nullaalapú indexét a teljes forrássztringben.
IndexOf(String, Char, Int32, CompareOptions)	Megkeresi a megadott karaktert, és a forrássztring szakaszán belül az első előfordulás nulla alapú indexét adja vissza, amely a megadott indextől a sztring végéig terjed a megadott CompareOptions érték használatával.
IndexOf(String, Char, Int32, Int32, CompareOptions)	Megkeresi a megadott karaktert, és visszaadja a forrássztring azon szakaszának első előfordulásának nulla alapú indexét, amely a megadott indexnél kezdődik, és a megadott CompareOptions értéket használó elemek számát tartalmazza.
IndexOf(String, Char, Int32, Int32)	Megkeresi a megadott karaktert, és visszaadja a forrássztring azon szakaszának első előfordulásának nulla alapú indexét, amely a megadott indexnél kezdődik, és a megadott számú elemet tartalmazza.
IndexOf(String, Char, Int32)	Megkeresi a megadott karaktert, és visszaadja a forrássztring első előfordulásának nulla alapú indexét, amely a megadott indextől a sztring végéig terjed.
IndexOf(String, Char)	Megkeresi a megadott karaktert, és az első előfordulás nulla alapú indexét adja vissza a teljes forrássztringen belül.
IndexOf(String, String, CompareOptions)	Megkeresi a megadott alsztringet, és a megadott CompareOptions érték használatával visszaadja az első előfordulás nulla alapú indexét a teljes forrássztringen belül.
IndexOf(String, String, Int32, CompareOptions)	Megkeresi a megadott alsztringet, és a forrássztring szakaszán belüli első előfordulás nulla alapú indexét adja vissza, amely a megadott indextől a sztring végéig terjed a megadott CompareOptions érték használatával.
IndexOf(String, String, Int32, Int32, CompareOptions)	Megkeresi a megadott alsztringet, és visszaadja a forrássztring azon szakaszának első előfordulásának nulla alapú indexét, amely a megadott indexnél kezdődik, és a megadott számú elemet tartalmazza a megadott CompareOptions érték használatával.
IndexOf(String, String, Int32, Int32)	Megkeresi a megadott alsztringet, és visszaadja a forrássztring azon szakaszának első előfordulásának nulla alapú indexét, amely a megadott indexnél kezdődik, és a megadott számú elemet tartalmazza.
IndexOf(String, String, Int32)	Megkeresi a megadott alsztringet, és visszaadja a forrássztring első előfordulásának nulla alapú indexét, amely a megadott indextől a sztring végéig terjed.
IndexOf(String, String)	Megkeresi a megadott részsztringet, és a teljes forrássztringen belül visszaadja az első előfordulás nullaalapú indexét.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Meghatározza, hogy egy sztring egy adott előtaggal kezdődik-e.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Meghatározza, hogy egy írásvédett karakter egy adott előtaggal kezdődik-e.
IsPrefix(String, String, CompareOptions)	Meghatározza, hogy a megadott forrássztring a megadott előtaggal kezdődik-e a megadott CompareOptions érték használatával.
IsPrefix(String, String)	Meghatározza, hogy a megadott forrássztring a megadott előtaggal kezdődik-e.
IsSortable(Char)	Azt jelzi, hogy egy megadott Unicode-karakter rendezhető-e.
IsSortable(ReadOnlySpan<Char>)	Azt jelzi, hogy egy megadott Unicode írásvédett karaktertartomány rendezhető-e.
IsSortable(Rune)	Azt jelzi, hogy egy megadott Rune rendezhető-e.
IsSortable(String)	Azt jelzi, hogy egy megadott Unicode-sztring rendezhető-e.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Meghatározza, hogy egy sztring egy adott utótaggal végződik-e.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Meghatározza, hogy egy írásvédett karakter egy adott utótaggal végződik-e.
IsSuffix(String, String, CompareOptions)	Meghatározza, hogy a megadott forrássztring a megadott utótaggal végződik-e a megadott CompareOptions érték használatával.
IsSuffix(String, String)	Meghatározza, hogy a megadott forrássztring a megadott utótaggal végződik-e.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Egy forrássztringben lévő részsztring utolsó előfordulását keresi.
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	A megadott írásvédett karaktertartományon belüli részszűkítés utolsó előfordulását keresi.
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	Megkeresi a megadott írásvédett karaktertartományon belüli utolsó előfordulást Rune .
LastIndexOf(String, Char, CompareOptions)	Megkeresi a megadott karaktert, és a megadott CompareOptions érték használatával visszaadja az utolsó előfordulás nulla alapú indexét a teljes forrássztringben.
LastIndexOf(String, Char, Int32, CompareOptions)	Megkeresi a megadott karaktert, és a forrássztring azon szakaszának utolsó előfordulásának nulla alapú indexét adja vissza, amely a sztring elejétől a megadott indexig terjed a megadott CompareOptions érték használatával.
LastIndexOf(String, Char, Int32, Int32, CompareOptions)	Megkeresi a megadott karaktert, és a forrássztring azon szakaszának utolsó előfordulásának nulla alapú indexét adja vissza, amely a megadott számú elemet tartalmazza, és a megadott érték használatával végződik a megadott CompareOptions indexben.
LastIndexOf(String, Char, Int32, Int32)	Megkeresi a megadott karaktert, és a forrássztring azon szakaszának utolsó előfordulásának nulla alapú indexét adja vissza, amely a megadott számú elemet tartalmazza, és a megadott indexre végződik.
LastIndexOf(String, Char, Int32)	Megkeresi a megadott karaktert, és a forrássztring azon szakaszának utolsó előfordulásának nulla alapú indexét adja vissza, amely a sztring elejétől a megadott indexig terjed.
LastIndexOf(String, Char)	Megkeresi a megadott karaktert, és a teljes forrássztringben az utolsó előfordulás nulla alapú indexét adja vissza.
LastIndexOf(String, String, CompareOptions)	Megkeresi a megadott alsztringet, és a megadott CompareOptions érték használatával visszaadja az utolsó előfordulás nulla alapú indexét a teljes forrássztringen belül.
LastIndexOf(String, String, Int32, CompareOptions)	Megkeresi a megadott alsztringet, és a forrássztring szakaszán belüli utolsó előfordulás nulla alapú indexét adja vissza, amely a sztring elejétől a megadott indexig terjed a megadott CompareOptions érték használatával.
LastIndexOf(String, String, Int32, Int32, CompareOptions)	Megkeresi a megadott alsztringet, és a forrássztring azon szakaszának utolsó előfordulásának nulla alapú indexét adja vissza, amely a megadott számú elemet tartalmazza, és a megadott érték használatával végződik a megadott CompareOptions indexben.
LastIndexOf(String, String, Int32, Int32)	Megkeresi a megadott alsztringet, és visszaadja a forrássztring azon szakaszának utolsó előfordulásának nulla alapú indexét, amely a megadott számú elemet tartalmazza, és a megadott indexre végződik.
LastIndexOf(String, String, Int32)	Megkeresi a megadott alsztringet, és visszaadja a forrássztring utolsó előfordulásának nulla alapú indexét, amely a sztring elejétől a megadott indexig terjed.
LastIndexOf(String, String)	Megkeresi a megadott alsztringet, és a teljes forrássztringben az utolsó előfordulás nulla alapú indexét adja vissza.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális CompareInfo objektumot jelképező sztringet ad vissza.

Explicit interfész-implementációk

Name	Description
IDeserializationCallback.OnDeserialization(Object)	A teljes objektumdiagram deszerializálása után fut.

Bővítő metódusok

Name	Description
GetStringComparer(CompareInfo, CompareOptions)	Egy objektumot StringComparer a megadott objektum kultúraérzékeny sztring-összehasonlító szabályai alapján ad CompareInfo vissza.

Lásd még

• Súlytáblák Windows operációs rendszerekhez
• Alapértelmezett Unicode rendezési elemtáblázat Linux és macOS rendszeren