다음을 통해 공유


CharEnumerator 클래스

String 개체의 반복과 해당 문자열의 개별 문자 읽기를 지원합니다. 이 클래스는 상속될 수 없습니다.

네임스페이스: System
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class CharEnumerator
    Implements ICloneable, IEnumerator(Of Char), _
    IDisposable, IEnumerator
‘사용 방법
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

설명

CharEnumerator는 참조된 String 개체의 문자에 대한 읽기 전용 액세스를 제공합니다. 예를 들어, Microsoft Visual Basic 및 C# 프로그래밍 언어에서 컬렉션의 요소를 반복하는 foreach 문은 String 개체에서 CharEnumerator를 검색하여 해당 개체의 문자를 반복합니다.

CharEnumerator에 대한 공용 생성자는 없습니다. 대신, String 개체의 GetEnumerator 메서드를 호출하여, 문자열을 참조하도록 초기화되는 CharEnumerator를 가져옵니다.

CharEnumeratorCharEnumerator가 참조하는 문자열의 문자에 대한 내부 인덱스를 유지합니다. 이 열거자가 문자열에서 논리적으로 첫 번째 문자 앞이나 마지막 문자 뒤의 문자 위치를 참조할 때에는 인덱스의 상태가 유효하지 않으며, 문자열 내의 문자를 참조할 때에는 유효합니다. 인덱스는 논리적으로 첫 번째 문자 앞의 위치로 초기화되고 반복이 완료되면 마지막 문자 뒤의 위치로 설정됩니다. 인덱스가 유효하지 않은 동안 문자에 액세스하려고 하면 예외가 throw됩니다.

MoveNext 메서드는 첫 번째 및 다음 문자를 차례로 액세스하도록 인덱스를 1씩 증가시킵니다. Reset 메서드는 인덱스를 논리적으로 첫 번째 문자 앞의 위치로 설정합니다. Current 속성은 현재 인덱스에서 참조하는 문자를 검색합니다. Clone 메서드는 CharEnumerator의 복사본을 만듭니다.

참고

하나 이상의 스레드에 액세스하는 CharEnumerator의 여러 독립된 인스턴스는 String의 단일 인스턴스에 액세스할 수 있습니다. 이 클래스는 IEnumerator 인터페이스를 지원하기 위해 구현됩니다. 열거자의 사용과 관련된 자세한 내용은 IEnumerator 항목을 참조하십시오.

상속 계층 구조

System.Object
  System.CharEnumerator

스레드로부터의 안전성

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

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

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

CharEnumerator 멤버
System 네임스페이스
String
IEnumerator
IEnumerable
ICollection