StringInfo.GetNextTextElement Метод

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Возвращает первый текстовый элемент в заданной строке.

Перегрузки

GetNextTextElement(String)	Возвращает первый текстовый элемент в заданной строке.
GetNextTextElement(String, Int32)	Возвращает элемент текста по указанному индексу заданной строки.

GetNextTextElement(String)

Исходный код:

StringInfo.cs

Возвращает первый текстовый элемент в заданной строке.

public:
 static System::String ^ GetNextTextElement(System::String ^ str);

public static string GetNextTextElement (string str);

static member GetNextTextElement : string -> string

Public Shared Function GetNextTextElement (str As String) As String

Параметры

str

String

Строка, из которой нужно получить элемент текста.

Возвращаемое значение

String

Строка, содержащая первый текстовый элемент в заданной строке.

Исключения

ArgumentNullException

str имеет значение null.

Комментарии

.NET определяет текстовый элемент как единицу текста, отображаемую в виде одного символа, то есть графемы. Текстовый элемент может быть базовым символом, суррогатной парой или объединяющей последовательностью символов. Стандарт Юникода определяет суррогатную пару как закодированное представление символа для одного абстрактного символа, состоящего из последовательности из двух единиц кода, где первая единица пары является суррогатом высокого уровня, а вторая — суррогатом с низким уровнем. Стандарт Юникода определяет объединяющую последовательность символов как сочетание базового символа и одного или нескольких комбинирования символов. Суррогатная пара может представлять базовый или объединяющий символ.

Этот метод возвращает только первый текстовый элемент. Для итерации текстовых элементов строки приложение должно использовать объект, TextElementEnumerator созданный методом GetTextElementEnumerator .

См. также раздел

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Исходный код:

StringInfo.cs

Возвращает элемент текста по указанному индексу заданной строки.

public:
 static System::String ^ GetNextTextElement(System::String ^ str, int index);

public static string GetNextTextElement (string str, int index);

static member GetNextTextElement : string * int -> string

Public Shared Function GetNextTextElement (str As String, index As Integer) As String

Параметры

str

String

Строка, из которой нужно получить элемент текста.

index

Int32

Отсчитываемый от нуля индекс, с которого начинается элемент текста.

Возвращаемое значение

String

Строка, содержащая элемент текста по указанному индексу заданной строки.

Исключения

ArgumentNullException

str имеет значение null.

ArgumentOutOfRangeException

index находится вне диапазона допустимых индексов для str.

Комментарии

.NET определяет текстовый элемент как единицу текста, отображаемую в виде одного символа, то есть графемы. Текстовый элемент может быть базовым символом, суррогатной парой или объединяющей последовательностью символов. Стандарт Юникода определяет суррогатную пару как закодированное представление символа для одного абстрактного символа, состоящего из последовательности из двух единиц кода, где первая единица пары является суррогатом высокого уровня, а вторая — суррогатом с низким уровнем. Стандарт Юникода определяет объединяющую последовательность символов как сочетание базового символа и одного или нескольких комбинирования символов. Суррогатная пара может представлять базовый или объединяющий символ.

Этот метод возвращает только первый текстовый элемент подстроки, которая начинается с указанного индекса. Чтобы выполнить итерацию по текстовым элементам строки, приложение должно использовать объект , TextElementEnumerator созданный методом GetTextElementEnumerator .

См. также раздел

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)