Поделиться через


StringInfo.GetNextTextElement Метод

Определение

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

Перегрузки

GetNextTextElement(String)

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

GetNextTextElement(String, Int32)

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

GetNextTextElement(String)

Исходный код:
StringInfo.cs
Исходный код:
StringInfo.cs
Исходный код:
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

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

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

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

Исключения

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

Комментарии

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

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

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

Применяется к

GetNextTextElement(String, Int32)

Исходный код:
StringInfo.cs
Исходный код:
StringInfo.cs
Исходный код:
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

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

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

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

Исключения

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

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

Комментарии

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

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

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

Применяется к