CompareInfo.GetSortKey Metodo

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

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

Ottiene la chiave di ordinamento per la stringa specificata.

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

Parametri

source

String

Stringa per la quale viene ottenuto un oggetto SortKey.

Restituisce

SortKey

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

• SortKey

GetSortKey(String, CompareOptions)

Origine:

CompareInfo.cs

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

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

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

SortKey

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

Eccezioni

ArgumentException

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

• SortKey
• CompareOptions

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

Origine:

CompareInfo.cs

Calcola una chiave di ordinamento per l'input specificato.

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

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

Int32

Numero di byte scritti in destination.

Eccezioni

ArgumentException

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.