CharEnumerator-Klasse

Unterstützt das Durchlaufen eines String-Objekts und das Lesen der einzelnen Zeichen. Diese Klasse kann nicht geerbt werden.

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

Syntax

'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class CharEnumerator
    Implements ICloneable, IEnumerator(Of Char), _
    IDisposable, IEnumerator
'Usage
Dim instance As CharEnumerator

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public sealed class CharEnumerator : ICloneable, IEnumerator<char>, 
    IDisposable, IEnumerator

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class CharEnumerator sealed : ICloneable, IEnumerator<wchar_t>, 
    IDisposable, IEnumerator

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class CharEnumerator implements ICloneable, IEnumerator<char>, 
    IDisposable, IEnumerator

SerializableAttribute 
ComVisibleAttribute(true) 
public final class CharEnumerator implements ICloneable, IEnumerator<char>, 
    IDisposable, IEnumerator

Hinweise

Ein CharEnumerator stellt schreibgeschützten Zugriff auf die Zeichen eines String-Objekts bereit, auf das verwiesen wird. Die Anweisung foreach der Programmiersprachen Microsoft Visual Basic und C#, die die Elemente einer Auflistung durchläuft, ruft z. B. einen CharEnumerator aus einem String-Objekt ab, um die Zeichen in diesem Objekt zu durchlaufen.

Es gibt keinen öffentlichen Konstruktor für CharEnumerator. Stattdessen liefert der Aufruf der GetEnumerator-Methode eines String-Objekts einen CharEnumerator, der mit einem Verweis auf die Zeichenfolge initialisiert wird.

Ein CharEnumerator verwaltet einen internen Index für die Zeichen der Zeichenfolge, auf die der CharEnumerator verweist. Der Zustand des Index ist ungültig, wenn er auf eine Zeichenposition verweist, die sich logisch vor dem ersten oder hinter dem letzten Zeichen der Zeichenfolge befindet, und er ist gültig, wenn er auf ein Zeichen innerhalb der Zeichenfolge verweist. Der Index wird mit einer Position initialisiert, die sich logisch vor dem ersten Zeichen befindet, und er wird nach Abschluss der Iteration auf eine Position hinter dem letzten Zeichen festgelegt. Beim Versuch, auf ein Zeichen zuzugreifen, während der Index ungültig ist, wird eine Ausnahme ausgelöst.

Die MoveNext-Methode erhöht den Index um 1. Dadurch wird zuerst auf das erste und dann auf das jeweils nachfolgende Zeichen zugegriffen. Die Reset-Methode legt den Index auf eine Position fest, die sich logisch vor dem ersten Zeichen befindet. Die Current-Eigenschaft ruft das Zeichen ab, auf das der Index derzeit verweist. Die Clone-Methode erstellt eine Kopie des CharEnumerator.

Hinweis

Mehrere unabhängige Instanzen von CharEnumerator können aus einem oder mehreren Threads auf dieselbe Instanz von String zugreifen. Diese Klasse ist zur Unterstützung der IEnumerator-Schnittstelle implementiert. Weitere Informationen über die Verwendung von Enumeratoren finden Sie unter dem Thema IEnumerator.

Vererbungshierarchie

System.Object
  System.CharEnumerator

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

CharEnumerator-Member
System-Namespace
String
IEnumerator
IEnumerable
ICollection