StringInfo.GetTextElementEnumerator-Methode (String, Int32)

.NET Framework definiert ein Textelement als Texteinheit, die als einzelnes Zeichen, d. h. als Graphem, dargestellt wird. Ein Textelement kann ein Basiszeichen, ein Ersatzzeichenpaar oder eine Kombinationssequenz sein. Der Unicode-Standard definiert ein Ersatzzeichenpaar als codierte Zeichendarstellung für ein einzelnes abstraktes Zeichen, das aus einer Folge von zwei Codeeinheiten besteht. Dabei stellt die erste Einheit des Paars das hohe Ersatzzeichen und die zweite Einheit das niedrige Ersatzzeichen dar. Der Unicode-Standard definiert eine Kombinationszeichensequenz als Kombination aus einem Basiszeichen und einem oder mehreren Kombinationszeichen. Ein Ersatzzeichenpaar kann ein Basiszeichen oder ein Kombinationszeichen darstellen.

Der Textelementenumerator wird nur zum Lesen von Daten in der Zeichenfolge verwendet; er kann die zugrunde liegende Zeichenfolge nicht ändern. Ein Enumerator verfügt nicht über exklusiven Zugriff auf die Zeichenfolge.

Der Enumerator befindet sich in einem ungültigen Zustand, sobald er vor dem ersten Textelement oder hinter dem letzten Textelement der Zeichenfolge positioniert ist. Wenn sich der Enumerator in einem ungültigen Zustand befindet, löst ein Aufruf von Current eine Ausnahme aus.

Anfänglich wird der Enumerator vor dem ersten Textelement in der Zeichenfolge positioniert. Reset setzt den Enumerator ebenfalls auf diese Position zurück. Nach dem Erstellen eines Enumerators oder nach dem Aufrufen der Reset-Methode muss daher ein Aufruf von MoveNext erfolgen, um den Enumerator vor dem Lesen des Werts von Current vor dem ersten Textelement der Zeichenfolge zu positionieren.

Current gibt solange dasselbe Objekt zurück, bis MoveNext oder Reset aufgerufen wird.

Wenn das Ende der Zeichenfolge überschritten wird, befindet sich der Enumerator erneut in einem ungültigen Zustand, und beim Aufruf von MoveNext wird false zurückgegeben. Ein Aufruf von Current löst eine Ausnahme aus, wenn beim letzten Aufruf von MoveNext der Wert false zurückgegeben wurde.

.NET Framework

.NET Framework Client Profile

Portable Klassenbibliothek

.NET für Windows Store-Apps

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz