StringInfo.GetNextTextElement StringInfo.GetNextTextElement StringInfo.GetNextTextElement StringInfo.GetNextTextElement Method

Definition

Ruft das erste Textelement in einer angegebenen Zeichenfolge ab.Gets the first text element in a specified string.

Überlädt

GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String)

Ruft das erste Textelement in einer angegebenen Zeichenfolge ab.Gets the first text element in a specified string.

GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32)

Ruft das Textelement am angegebenen Index der angegebenen Zeichenfolge ab.Gets the text element at the specified index of the specified string.

GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String)

Ruft das erste Textelement in einer angegebenen Zeichenfolge ab.Gets the first text element in a specified string.

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

Parameter

str
String String String String

Die Zeichenfolge, aus der das Textelement abgerufen werden soll.The string from which to get the text element.

Gibt zurück

Eine Zeichenfolge, die das erste Textelement aus der angegebenen Zeichenfolge enthält.A string containing the first text element in the specified string.

Ausnahmen

Hinweise

.Net definiert ein Textelement als eine Textzeile, die als einzelnes Zeichen, d. h. als Grapheme, angezeigt wird..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. Ein Textelement kann ein Basiszeichen, ein Ersatz Zeichenpaar oder eine kombinierte Zeichenfolge sein.A text element can be a base character, a surrogate pair, or a combining character sequence. Der Unicode-Standard definiert ein Ersatz Zeichenpaar als codierte Zeichen Darstellung für ein einzelnes abstraktes Zeichen, das aus einer Sequenz von zwei Code Einheiten besteht, wobei die erste Einheit des Paars ein hohes Ersatz Zeichen und das zweite ein niedriges Ersatz Zeichen ist.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. Der Unicode-Standard definiert eine kombinierte Zeichenfolge als eine Kombination aus einem Basiszeichen und einem oder mehreren kombinierten Zeichen.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Ein Ersatz Zeichenpaar kann ein Basiszeichen oder ein Kombinations Zeichen darstellen.A surrogate pair can represent a base character or a combining character.

Diese Methode gibt nur das erste Textelement zurück.This method only returns the first text element. Um die Textelemente der Zeichenfolge zu durchlaufen, sollte die Anwendung das TextElementEnumerator -Objekt verwenden, das von der GetTextElementEnumerator -Methode generiert wurde.To iterate through the text elements of the string, the application should use the TextElementEnumerator object generated by the GetTextElementEnumerator method.

Siehe auch

GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32)

Ruft das Textelement am angegebenen Index der angegebenen Zeichenfolge ab.Gets the text element at the specified index of the specified string.

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

Parameter

str
String String String String

Die Zeichenfolge, aus der das Textelement abgerufen werden soll.The string from which to get the text element.

index
Int32 Int32 Int32 Int32

Der nullbasierte Index, an dem das Textelement beginnt.The zero-based index at which the text element starts.

Gibt zurück

Eine Zeichenfolge, die das Textelement am angegebenen Index der angegebenen Zeichenfolge enthält.A string containing the text element at the specified index of the specified string.

Ausnahmen

index liegt außerhalb des Bereichs der gültigen Indizes für str.index is outside the range of valid indexes for str.

Hinweise

.Net definiert ein Textelement als eine Textzeile, die als einzelnes Zeichen, d. h. als Grapheme, angezeigt wird..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. Ein Textelement kann ein Basiszeichen, ein Ersatz Zeichenpaar oder eine kombinierte Zeichenfolge sein.A text element can be a base character, a surrogate pair, or a combining character sequence. Der Unicode-Standard definiert ein Ersatz Zeichenpaar als codierte Zeichen Darstellung für ein einzelnes abstraktes Zeichen, das aus einer Sequenz von zwei Code Einheiten besteht, wobei die erste Einheit des Paars ein hohes Ersatz Zeichen und das zweite ein niedriges Ersatz Zeichen ist.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. Der Unicode-Standard definiert eine kombinierte Zeichenfolge als eine Kombination aus einem Basiszeichen und einem oder mehreren kombinierten Zeichen.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Ein Ersatz Zeichenpaar kann ein Basiszeichen oder ein Kombinations Zeichen darstellen.A surrogate pair can represent a base character or a combining character.

Diese Methode gibt nur das erste Textelement der Teil Zeichenfolge zurück, die am angegebenen Index beginnt.This method only returns the first text element of the substring that starts at the specified index. Um die Textelemente der Zeichenfolge zu durchlaufen, sollte die Anwendung den verwenden TextElementEnumerator , der von GetTextElementEnumerator der-Methode generiert wurde.To iterate through the text elements of the string, the application should use the TextElementEnumerator generated by the GetTextElementEnumerator method.

Siehe auch

Gilt für: