CompareInfo.GetSortKey Methode

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Ruft ein SortKey-Objekt für eine Zeichenfolge ab.

Überlädt

GetSortKey(String)	Ruft den Sortierschlüssel für die angegebene Zeichenfolge ab.
GetSortKey(String, CompareOptions)	Ruft mithilfe des angegebenen SortKey-Werts ein CompareOptions-Objekt für die angegebenen Zeichenfolge ab.
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)	Berechnet einen Sortierschlüssel für die Eingabe.

GetSortKey(String)

Quelle:

CompareInfo.cs

Ruft den Sortierschlüssel für die angegebene Zeichenfolge ab.

public:
 System::Globalization::SortKey ^ GetSortKey(System::String ^ source);

public System.Globalization.SortKey GetSortKey (string source);

member this.GetSortKey : string -> System.Globalization.SortKey

Public Function GetSortKey (source As String) As SortKey

Parameter

source

String

Die Zeichenfolge, für die ein SortKey-Objekt abgerufen wird.

Gibt zurück

SortKey

Das SortKey-Objekt, das den Sortierschlüssel für die angegebene Zeichenfolge enthält.

Hinweise

Jedes Zeichen in einer Zeichenfolge erhält mehrere Kategorien von Sortiergewichtungen, einschließlich Skript, Alphabet, Groß- und Kleinschreibung und diakritischer Gewichtung. Ein Sortierschlüssel ist das Repository dieser Gewichtungen für eine bestimmte Zeichenfolge. Ein Sortierschlüssel kann z. B. eine Zeichenfolge mit alphabetischen Gewichtungen enthalten, dann eine Zeichenfolge mit Gewichtungen nach Groß-/Kleinschreibung usw. Die GetSortKey -Methode entspricht der Windows-API-Methode LCMapString mit dem flag LCMAP_SORTKEY.

Weitere Informationen

• SortKey

GetSortKey(String, CompareOptions)

Quelle:

CompareInfo.cs

Ruft mithilfe des angegebenen SortKey-Werts ein CompareOptions-Objekt für die angegebenen Zeichenfolge ab.

public:
 System::Globalization::SortKey ^ GetSortKey(System::String ^ source, System::Globalization::CompareOptions options);

public System.Globalization.SortKey GetSortKey (string source, System.Globalization.CompareOptions options);

member this.GetSortKey : string * System.Globalization.CompareOptions -> System.Globalization.SortKey

Public Function GetSortKey (source As String, options As CompareOptions) As SortKey

Parameter

source

String

Die Zeichenfolge, für die ein SortKey-Objekt abgerufen wird.

options

CompareOptions

Eine bitweise Kombination aus einem oder mehreren der folgenden Enumerationswerte, die definieren, wie der Sortierschlüssel berechnet wird: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth, IgnoreKanaType und StringSort.

Gibt zurück

SortKey

Das SortKey-Objekt, das den Sortierschlüssel für die angegebene Zeichenfolge enthält.

Ausnahmen

ArgumentException

options enthält einen ungültigen CompareOptions-Wert.

Hinweise

Jedes Zeichen in einer Zeichenfolge erhält mehrere Kategorien von Sortiergewichtungen, einschließlich Skript, Alphabet, Groß- und Kleinschreibung und diakritischer Gewichtung. Ein Sortierschlüssel ist das Repository dieser Gewichtungen für eine bestimmte Zeichenfolge. Ein Sortierschlüssel kann z. B. eine Zeichenfolge mit alphabetischen Gewichtungen enthalten, dann eine Zeichenfolge mit Gewichtungen nach Groß-/Kleinschreibung usw. Die GetSortKey -Methode entspricht der Windows-API-Methode LCMapString mit dem flag LCMAP_SORTKEY.

Weitere Informationen

• SortKey
• CompareOptions

GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)

Quelle:

CompareInfo.cs

Berechnet einen Sortierschlüssel für die Eingabe.

public int GetSortKey (ReadOnlySpan<char> source, Span<byte> destination, System.Globalization.CompareOptions options = System.Globalization.CompareOptions.None);

member this.GetSortKey : ReadOnlySpan<char> * Span<byte> * System.Globalization.CompareOptions -> int

Public Function GetSortKey (source As ReadOnlySpan(Of Char), destination As Span(Of Byte), Optional options As CompareOptions = System.Globalization.CompareOptions.None) As Integer

Parameter

source

ReadOnlySpan<Char>

Der Text, für den der Sortierschlüssel abgerufen werden soll.

destination

Span<Byte>

Der Puffer, in den die resultierenden Sortierschlüsselbytes gespeichert werden.

options

CompareOptions

Eine optionale Kombination aus CompareOptions-Enumerationswerten, die für die Berechnung des Sortierschlüssels verwendet werden sollen. Der Standardwert ist None.

Gibt zurück

Int32

Die Anzahl der Bytes, die in destination geschrieben wurden.

Ausnahmen

ArgumentException

destination ist zu klein, um den resultierenden Sortierschlüssel zu enthalten, oder options enthält ein nicht unterstütztes Flag, oder source kann nicht mithilfe der gewünschten CompareOptions-Enumeration in der aktuellen CompareInfo-Klasse verarbeitet werden.

Hinweise

Verwenden Sie GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions) zum Abfragen der erforderlichen Größe von destination. Es ist akzeptabel, für diese Methode einen größer als erforderlichen Ausgabepuffer bereitzustellen.