CompareInfo.GetSortKey Metodo

Definizione

Ottiene un oggetto SortKey per una stringa.

Overload

GetSortKey(String)

Ottiene la chiave di ordinamento per la stringa specificata.

GetSortKey(String, CompareOptions)

Ottiene un oggetto SortKey per la stringa specificata usando il valore CompareOptions specificato.

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

Calcola una chiave di ordinamento per l'input specificato.

GetSortKey(String)

Origine:
CompareInfo.cs
Origine:
CompareInfo.cs
Origine:
CompareInfo.cs

Ottiene la chiave di ordinamento per la stringa specificata.

C#
public System.Globalization.SortKey GetSortKey (string source);
C#
public virtual System.Globalization.SortKey GetSortKey (string source);

Parametri

source
String

Stringa per la quale viene ottenuto un oggetto SortKey.

Restituisce

Oggetto SortKey che contiene la chiave di ordinamento per la stringa specificata.

Commenti

Ogni carattere in una stringa è dato a diverse categorie di pesi di ordinamento, tra cui script, alfabetico, case e pesi diacritici. Una chiave di ordinamento è il repository di questi pesi per una determinata stringa. Ad esempio, una chiave di ordinamento potrebbe contenere una stringa di pesi alfabetici, seguita da una stringa di pesi maiuscole e così via. Il GetSortKey metodo equivale al metodo LCMapString API di Windows con il flag di LCMAP_SORTKEY.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetSortKey(String, CompareOptions)

Origine:
CompareInfo.cs
Origine:
CompareInfo.cs
Origine:
CompareInfo.cs

Ottiene un oggetto SortKey per la stringa specificata usando il valore CompareOptions specificato.

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

Parametri

source
String

Stringa per la quale viene ottenuto un oggetto SortKey.

options
CompareOptions

Combinazione bit per bit di uno o più dei seguenti valori di enumerazione che definiscono come viene calcolata la chiave di ordinamento: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth, IgnoreKanaType e StringSort.

Restituisce

Oggetto SortKey che contiene la chiave di ordinamento per la stringa specificata.

Eccezioni

options contiene un valore di CompareOptions non valido.

Commenti

Ogni carattere in una stringa è dato a diverse categorie di pesi di ordinamento, tra cui script, alfabetico, case e pesi diacritici. Una chiave di ordinamento è il repository di questi pesi per una determinata stringa. Ad esempio, una chiave di ordinamento potrebbe contenere una stringa di pesi alfabetici, seguita da una stringa di pesi maiuscole e così via. Il GetSortKey metodo equivale al metodo LCMapString API di Windows con il flag di LCMAP_SORTKEY.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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

Origine:
CompareInfo.cs
Origine:
CompareInfo.cs
Origine:
CompareInfo.cs

Calcola una chiave di ordinamento per l'input specificato.

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

Parametri

source
ReadOnlySpan<Char>

Testo per cui ottenere la chiave di ordinamento.

destination
Span<Byte>

Buffer in cui vengono archiviati i byte della chiave di ordinamento risultante.

options
CompareOptions

Combinazione facoltativa di valori di enumerazione di CompareOptions da usare per il calcolo della chiave di ordinamento. Il valore predefinito è None.

Restituisce

Numero di byte scritti in destination.

Eccezioni

Le dimensioni di destination sono insufficienti per contenere la chiave di ordinamento risultante, options contiene un flag non supportato oppure non è possibile elaborare source usando l'oggetto CompareOptions desiderato nell'oggetto CompareInfo corrente.

Commenti

Usare GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions) per eseguire query sulle dimensioni necessarie di destination. È accettabile fornire un buffer di output più grande del necessario a questo metodo.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 5, 6, 7, 8, 9