TextElementEnumerator.Current-Eigenschaft

Ruft das aktuelle Textelement in der Zeichenfolge ab.

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public ReadOnly Property Current As Object
'Usage
Dim instance As TextElementEnumerator
Dim value As Object

value = instance.Current

public Object Current { get; }

public:
virtual property Object^ Current {
    Object^ get () sealed;
}

/** @property */
public final Object get_Current ()

public final function get Current () : Object

Eigenschaftenwert

Ein Objekt, das das aktuelle Textelement in der Zeichenfolge enthält.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Der Enumerator ist vor dem ersten Textelement oder hinter dem letzten Textelement der Zeichenfolge positioniert.

Hinweise

.NET Framework definiert ein Textelement als eine Texteinheit, die als einzelnes Zeichen, d. h. als Graphem, dargestellt wird. Ein Textelement kann ein Basiszeichen, ein Ersatzzeichenpaar oder eine Kombinationszeichenfolge 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 Paares das hohe Ersatzzeichen und die zweite Einheit das niedrige Ersatzzeichen dar. Der Unicode-Standard definiert eine Kombinationszeichenfolge als Kombination aus einem Basiszeichen und einem oder mehreren Kombinationszeichen. Ein Ersatzzeichenpaar kann ein Basiszeichen oder ein Kombinationszeichen darstellen. Weitere Informationen über Ersatzzeichenpaare und Kombinationszeichenfolgen finden Sie im Unicode-Standard unter http://www.unicode.org (nur auf Englisch verfügbar).

Nach dem Erstellen eines Enumerators oder nach dem Aufrufen der Reset-Methode muss ein Aufruf von MoveNext erfolgen, um den Enumerator vor dem ersten Textelement der Zeichenfolge zu positionieren, bevor der Wert von Current gelesen wird. Andernfalls ist Current nicht definiert.

Außerdem löst Current eine Ausnahme aus, wenn beim letzten Aufruf von MoveNext false zurückgegeben wurde, wodurch das Ende der Zeichenfolge angegeben wird.

Current ändert die Position des Enumerators nicht. Nachfolgende Aufrufe von Current geben daher das gleiche Objekt zurück, bis entweder MoveNext oder Reset aufgerufen wird.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextElementEnumerator-Klasse
TextElementEnumerator-Member
System.Globalization-Namespace
GetTextElement
ElementIndex
MoveNext
Reset