다음을 통해 공유

GetEnumerator 메서드(Collection 개체)

  • 아티클

업데이트: 2007년 11월

Collection 개체(Visual Basic)를 반복하는 데 사용되는 열거자 개체에 대한 참조를 반환합니다.

Public Function GetEnumerator() As IEnumerator

설명

For Each...Next 문(Visual Basic)은 GetEnumerator를 호출하여 컬렉션 요소에서의 반복을 지원하기 위한 열거자 개체를 얻습니다. 일반적으로 For Each...Next 루프를 사용하여 컬렉션이나 배열을 탐색하며 GetEnumerator를 명시적으로 호출할 필요가 없습니다.

For Each...Next 문이 제공하는 것보다 정교하게 반복 작업을 제어해야 하는 경우에는 GetEnumerator 메서드를 사용하여 사용자 지정 탐색을 수행할 수 있습니다. 다음은 이러한 작업을 수행할 수 있는 몇 가지 경우입니다.

  • 컬렉션의 시작 부분으로 돌아가 반복이 끝나기 전에 다시 시작하려는 경우

  • 다양한 이유로 인해 하나 이상의 요소를 건너뛰려는 경우

  • 탐색 도중에 컬렉션의 요소를 변경해야 하는 경우. 이 경우에는 이전 열거자 개체가 무효화되므로 새 열거자 개체를 얻어야 합니다.

예제

다음 예제에서는 GetEnumerator를 사용하여 Collection 개체의 모든 요소를 검색하는 방법을 보여 줍니다.

Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
    thisCustomer = custEnum.Current()
    ' Insert code to process this element of the collection.
End While

GetEnumerator는 열거자 개체를 생성 및 반환합니다. 이 개체는 System.Collections 네임스페이스의 IEnumerator 인터페이스를 구현합니다. 열거자 개체는 Current 속성과 MoveNext 및 Reset 메서드를 노출합니다. 자세한 내용은 For Each...Next 문(Visual Basic)을 참조하십시오.

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Collection

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

참고 항목

참조

Collection 개체(Visual Basic)