StringInfo.GetNextTextElement Method (String)
Assembly: mscorlib (in mscorlib.dll)
The string from which to get the text element.
Return ValueA string containing the first text element in the specified string.
str is a null reference (Nothing in Visual Basic).
The .NET Framework defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. A text element can be a base character, a surrogate pair, or a combining character sequence. The Unicode Standard defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. A surrogate pair can represent a base character or a combining character. For more information on surrogate pairs and combining character sequences, see The Unicode Standard at http://www.unicode.org..
This method only returns the first text element. To iterate through the text elements of the string, the application should use the TextElementEnumerator generated by the GetTextElementEnumerator method.