StringInfo.GetNextTextElement Метод

Определение

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

System.Globalization

Сборки:

netstandard.dll, 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)