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 Einheit der Text, der als ein einzelnes Zeichen, d. h. eine zwischen graphemgruppen 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 es sich um ein Basiszeichen, ein Ersatzzeichenpaar oder eine Kombination von Zeichen Sequenz.A text element can be a base character, a surrogate pair, or a combining character sequence. Die Unicode-Standard definiert ein Ersatzzeichenpaar als eine codierte zeichendarstellung für ein einzelnes abstraktes Zeichen, die eine Sequenz von zwei Codeeinheiten, bestehen aus, wobei die erste Einheit des Paars ist ein hohes Ersatzzeichen und die zweite mit niedriger Ersatzzeichen.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. Die Unicode-Standard definiert eine Kombination von Zeichen der Sequenz als eine Kombination aus einem Basiszeichen und mindestens eine Kombination von Zeichen.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Ein Ersatzzeichenpaar kann es sich um ein Basiszeichen oder eine Kombination von Zeichen darstellen.A surrogate pair can represent a base character or a combining character.

Diese Methode gibt nur das erste Textelement.This method only returns the first text element. Um mit die Textelemente der Zeichenfolge zu durchlaufen, sollte die Anwendung verwenden die TextElementEnumerator Objekt, das generiert wird, durch die GetTextElementEnumerator Methode.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 Einheit der Text, der als ein einzelnes Zeichen, d. h. eine zwischen graphemgruppen 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 es sich um ein Basiszeichen, ein Ersatzzeichenpaar oder eine Kombination von Zeichen Sequenz.A text element can be a base character, a surrogate pair, or a combining character sequence. Die Unicode-Standard definiert ein Ersatzzeichenpaar als eine codierte zeichendarstellung für ein einzelnes abstraktes Zeichen, die eine Sequenz von zwei Codeeinheiten, bestehen aus, wobei die erste Einheit des Paars ist ein hohes Ersatzzeichen und die zweite mit niedriger Ersatzzeichen.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 Kombination von Zeichen der Sequenz als eine Kombination aus einem Basiszeichen und mindestens eine Kombination von Zeichen.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Ein Ersatzzeichenpaar kann es sich um ein Basiszeichen oder eine Kombination von Zeichen darstellen.A surrogate pair can represent a base character or a combining character.

Diese Methode gibt nur das erste Textelement der Teilzeichenfolge, die am angegebenen Index beginnt.This method only returns the first text element of the substring that starts at the specified index. Um mit die Textelemente der Zeichenfolge zu durchlaufen, sollte die Anwendung verwenden die TextElementEnumerator generiert, indem die GetTextElementEnumerator Methode.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: