CompareInfo.GetSortKey 메서드

정의

문자열에 대한 SortKey 개체를 가져옵니다.

오버로드

GetSortKey(String)

지정된 문자열의 정렬 키를 가져옵니다.

GetSortKey(String, CompareOptions)

지정된 SortKey 값을 사용하여 지정된 문자열의 CompareOptions 개체를 가져옵니다.

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

지정된 입력에 대한 정렬 키를 컴퓨팅합니다.

GetSortKey(String)

지정된 문자열의 정렬 키를 가져옵니다.

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

매개 변수

source
String

SortKey 개체를 가져올 문자열입니다.

반환

SortKey

지정된 문자열의 정렬 키가 들어 있는 SortKey 개체입니다.

설명

문자열의 각 문자에는 스크립트, 알파벳, 대/소문자 및 발음 가중치를 비롯한 여러 범주의 정렬 가중치가 제공됩니다. 정렬 키는 특정 문자열에 대한 이러한 가중치의 리포지토리입니다. 예를 들어 정렬 키에는 알파벳 가중치 문자열과 대/소문자 가중치 문자열 등이 포함될 수 있습니다. 이 GetSortKey 메서드는 LCMAP_SORTKEY 플래그가 있는 Windows API 메서드 LCMapString 와 동일합니다.

추가 정보

적용 대상

GetSortKey(String, CompareOptions)

지정된 SortKey 값을 사용하여 지정된 문자열의 CompareOptions 개체를 가져옵니다.

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

매개 변수

source
String

SortKey 개체를 가져올 문자열입니다.

options
CompareOptions

정렬 키가 계산되는 방법을 정의하는 IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth, IgnoreKanaTypeStringSort 열거형 값 중 하나 이상의 비트 조합입니다.

반환

SortKey

지정된 문자열의 정렬 키가 들어 있는 SortKey 개체입니다.

예외

options에 잘못된 CompareOptions 값이 포함된 경우

설명

문자열의 각 문자에는 스크립트, 알파벳, 대/소문자 및 분음 부호 가중치를 비롯한 여러 범주의 정렬 가중치가 제공됩니다. 정렬 키는 특정 문자열에 대한 이러한 가중치의 리포지토리입니다. 예를 들어 정렬 키에는 사전순 가중치 문자열과 대/소문자 가중치 문자열 등이 포함될 수 있습니다. 이 GetSortKey 메서드는 LCMAP_SORTKEY 플래그가 있는 Windows API 메서드 LCMapString 와 동일합니다.

추가 정보

적용 대상

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

지정된 입력에 대한 정렬 키를 컴퓨팅합니다.

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

매개 변수

source
ReadOnlySpan<Char>

정렬 키를 가져올 텍스트입니다.

destination
Span<Byte>

생성된 정렬 키 바이트가 저장되는 버퍼입니다.

options
CompareOptions

정렬 키 컴퓨팅에 사용할 CompareOptions 열거형 값의 선택적 조합입니다. 기본값은 None입니다.

반환

Int32

destination에 쓰인 바이트 수입니다.

예외

destination이 너무 작아서 생성된 정렬 키를 포함할 수 없거나, options가 지원되지 않는 플래그를 포함하거나, 현재 CompareInfo에서 원하는 CompareOptions를 사용하여 source를 처리할 수 없습니다.

설명

의 필요한 크기를 destination쿼리하는 데 사용합니다GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions). 이 메서드에 필요한 것보다 큰 출력 버퍼를 제공할 수 있습니다.

적용 대상