Freigeben über


CompareInfo.GetSortKey Methode

Definition

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
Quelle:
CompareInfo.cs
Quelle:
CompareInfo.cs

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

public:
 System::Globalization::SortKey ^ GetSortKey(System::String ^ source);
public:
 virtual System::Globalization::SortKey ^ GetSortKey(System::String ^ source);
public System.Globalization.SortKey GetSortKey (string source);
public virtual System.Globalization.SortKey GetSortKey (string source);
member this.GetSortKey : string -> System.Globalization.SortKey
abstract member GetSortKey : string -> System.Globalization.SortKey
override this.GetSortKey : string -> System.Globalization.SortKey
Public Function GetSortKey (source As String) As SortKey
Public Overridable Function GetSortKey (source As String) As SortKey

Parameter

source
String

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

Gibt zurück

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 Schrift, Alphabet, Groß-/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

Gilt für:

GetSortKey(String, CompareOptions)

Quelle:
CompareInfo.cs
Quelle:
CompareInfo.cs
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:
 virtual System::Globalization::SortKey ^ GetSortKey(System::String ^ source, System::Globalization::CompareOptions options);
public System.Globalization.SortKey GetSortKey (string source, System.Globalization.CompareOptions options);
public virtual System.Globalization.SortKey GetSortKey (string source, System.Globalization.CompareOptions options);
member this.GetSortKey : string * System.Globalization.CompareOptions -> System.Globalization.SortKey
abstract member GetSortKey : string * System.Globalization.CompareOptions -> System.Globalization.SortKey
override this.GetSortKey : string * System.Globalization.CompareOptions -> System.Globalization.SortKey
Public Function GetSortKey (source As String, options As CompareOptions) As SortKey
Public Overridable 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

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

Ausnahmen

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

Hinweise

Jedes Zeichen in einer Zeichenfolge erhält mehrere Kategorien von Sortiergewichtungen, einschließlich Schrift, Alphabet, Groß-/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

Gilt für:

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

Quelle:
CompareInfo.cs
Quelle:
CompareInfo.cs
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

Die Anzahl der Bytes, die in destination geschrieben wurden.

Ausnahmen

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) , um die erforderliche Größe von destinationabzufragen. Es ist akzeptabel, für diese Methode einen Ausgabepuffer bereitzustellen, der größer als erforderlich ist.

Gilt für: