다음을 통해 공유


Collection.GetEnumerator 메서드

정의

컬렉션을 반복하는 열거자를 반환합니다.

public:
 System::Collections::IEnumerator ^ GetEnumerator();
public System.Collections.IEnumerator GetEnumerator ();
member this.GetEnumerator : unit -> System.Collections.IEnumerator
Public Function GetEnumerator () As IEnumerator

반환

컬렉션을 반복하는 데 사용할 수 있는 열거자입니다.

예제

다음 예제에서는 를 사용하여 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 는 네임스페이스의 인터페이스를 구현하는 열거자 개체를 IEnumeratorSystem.Collections 생성하고 반환합니다. 열거자 개체는 속성 및 및 Reset 메서드를 MoveNext 노출합니다Current. 자세한 내용은 For Each...를 참조하세요. 다음 문입니다.

설명

For Each... Next Statement는 를 호출 GetEnumerator 하여 컬렉션의 요소에 대한 반복을 지원하기 위해 열거자 개체를 가져옵니다. 일반적으로 ...Next 루프를 For Each사용하여 컬렉션 또는 배열을 트래버스하며 명시적으로 호출 GetEnumerator 할 필요가 없습니다.

...Next 문이 제공하는 것보다 For Each반복을 더 자세히 제어해야 하는 경우 메서드를 GetEnumerator 사용하여 사용자 지정된 순회를 수행할 수 있습니다. 다음은 이 작업을 수행해야 할 수 있는 몇 가지 경우입니다.

  • 컬렉션의 시작 부분으로 돌아가서 반복이 완료되기 전에 다시 시작할 수 있습니다.

  • 여러 가지 이유로 하나 이상의 요소를 건너뛸 수 있습니다.

  • 순회 중간에 있는 컬렉션의 요소를 변경해야 할 수 있습니다. 이 경우 이전 열거자 개체가 무효화되므로 새 열거자 개체를 가져와야 합니다.

적용 대상