StringInfo.GetNextTextElement Methode

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Ruft das erste Textelement in einer angegebenen Zeichenfolge ab.

Überlädt

GetNextTextElement(String)	Ruft das erste Textelement in einer angegebenen Zeichenfolge ab.
GetNextTextElement(String, Int32)	Ruft das Textelement am angegebenen Index der angegebenen Zeichenfolge ab.

GetNextTextElement(String)

Quelle:

StringInfo.cs

Ruft das erste Textelement in einer angegebenen Zeichenfolge ab.

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

Die Zeichenfolge, aus der das Textelement abgerufen werden soll.

Gibt zurück

String

Eine Zeichenfolge, die das erste Textelement aus der angegebenen Zeichenfolge enthält.

Ausnahmen

ArgumentNullException

str ist null.

Hinweise

.NET definiert ein Textelement als Eine Texteinheit, die als einzelnes Zeichen, d. h. ein Graphem, angezeigt wird. Ein Textelement kann ein Basiszeichen, ein Ersatzpaar oder eine kombinierende Zeichensequenz sein. Der Unicode-Standard definiert ein Ersatzpaar als codierte Zeichendarstellung für ein einzelnes abstraktes Zeichen, das aus einer Sequenz von zwei Codeeinheiten besteht, wobei die erste Einheit des Paares ein hohes Ersatzgat und die zweite ein niedriges Ersatzzeichen ist. Der Unicode-Standard definiert eine kombinationsbasierte Zeichenfolge als Kombination aus einem Basiszeichen und einem oder mehreren kombinierenden Zeichen. Ein Ersatzpaar kann ein Basiszeichen oder ein kombinierendes Zeichen darstellen.

Diese Methode gibt nur das erste Textelement zurück. Zum Durchlaufen der Textelemente der Zeichenfolge sollte die Anwendung das von der TextElementEnumeratorGetTextElementEnumerator -Methode generierte Objekt verwenden.

Weitere Informationen

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Quelle:

StringInfo.cs

Ruft das Textelement am angegebenen Index der angegebenen Zeichenfolge ab.

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

Die Zeichenfolge, aus der das Textelement abgerufen werden soll.

index

Int32

Der nullbasierte Index, an dem das Textelement beginnt.

Gibt zurück

String

Eine Zeichenfolge, die das Textelement am angegebenen Index der angegebenen Zeichenfolge enthält.

Ausnahmen

ArgumentNullException

str ist null.

ArgumentOutOfRangeException

index liegt außerhalb des Bereichs der gültigen Indizes für str.

Hinweise

.NET definiert ein Textelement als Eine Texteinheit, die als einzelnes Zeichen, d. h. ein Graphem, angezeigt wird. Ein Textelement kann ein Basiszeichen, ein Ersatzpaar oder eine kombinierende Zeichensequenz sein. Der Unicode-Standard definiert ein Ersatzpaar als codierte Zeichendarstellung für ein einzelnes abstraktes Zeichen, das aus einer Sequenz von zwei Codeeinheiten besteht, wobei die erste Einheit des Paares ein hohes Ersatzgat und die zweite ein niedriges Ersatzzeichen ist. Der Unicode-Standard definiert eine kombinationsbasierte Zeichenfolge als Kombination aus einem Basiszeichen und einem oder mehreren kombinierenden Zeichen. Ein Ersatzpaar kann ein Basiszeichen oder ein kombinierendes Zeichen darstellen.

Diese Methode gibt nur das erste Textelement der Teilzeichenfolge zurück, das am angegebenen Index beginnt. Zum Durchlaufen der Textelemente der Zeichenfolge sollte die Anwendung das von der TextElementEnumeratorGetTextElementEnumerator -Methode generierte verwenden.

Weitere Informationen

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)