Dictionary<TKey,TValue>.ValueCollection.IEnumerable.GetEnumerator Dictionary<TKey,TValue>.ValueCollection.IEnumerable.GetEnumerator Dictionary<TKey,TValue>.ValueCollection.IEnumerable.GetEnumerator Method

정의

컬렉션을 반복하는 열거자를 반환합니다.Returns an enumerator that iterates through a collection.

 virtual System::Collections::IEnumerator ^ System.Collections.IEnumerable.GetEnumerator() = System::Collections::IEnumerable::GetEnumerator;
System.Collections.IEnumerator IEnumerable.GetEnumerator ();
Function GetEnumerator () As IEnumerator Implements IEnumerable.GetEnumerator

반환

컬렉션에서 반복하는 데 사용할 수 있는 IEnumerator입니다.An IEnumerator that can be used to iterate through the collection.

구현

설명

합니다 foreach C# 언어의 (for each c + +에서는 For Each Visual Basic에서) 열거자의 복잡성을 숨깁니다.The foreach statement of the C# language (for each in C++, For Each in Visual Basic) hides the complexity of the enumerators. 그러므로 열거자를 직접 조작하는 대신 foreach를 사용하는 것이 좋습니다.Therefore, using foreach is recommended, instead of directly manipulating the enumerator.

열거자를 사용하여 컬렉션의 데이터를 읽을 수는 있지만 내부 컬렉션을 수정할 수는 없습니다.Enumerators can be used to read the data in the collection, but they cannot be used to modify the underlying collection.

처음에 열거자는 컬렉션의 첫 번째 요소 앞에 배치됩니다.Initially, the enumerator is positioned before the first element in the collection. Reset을 실행하면 열거자가 이 위치로 복원됩니다.Reset also brings the enumerator back to this position. 이 위치에서 Current는 정의되지 않습니다.At this position, Current is undefined. 따라서 MoveNext의 값을 읽기 전에 Current를 호출하여 열거자를 해당 컬렉션의 첫 번째 요소로 보내야 합니다.Therefore, you must call MoveNext to advance the enumerator to the first element of the collection before reading the value of Current.

Current에서는 MoveNext 또는 Reset이 호출될 때까지 동일한 개체를 반환합니다.Current returns the same object until either MoveNext or Reset is called. MoveNextCurrent를 다음 요소로 설정합니다.MoveNext sets Current to the next element.

경우 MoveNext 열거자를 컬렉션의 끝 컬렉션의 마지막 요소 뒤에 배치 되는 전달 하 고 MoveNext 반환 false합니다.If MoveNext passes the end of the collection, the enumerator is positioned after the last element in the collection and MoveNext returns false. 열거자가 있는 경우이 위치에 대 한 후속 호출은 MoveNext 반환할 수도 false합니다.When the enumerator is at this position, subsequent calls to MoveNext also return false. 마지막으로 호출 하는 경우 MoveNext 반환 false, Current 정의 되지 않습니다.If the last call to MoveNext returned false, Current is undefined. Current를 컬렉션의 첫째 요소에 다시 설정하려면 Reset을 호출한 뒤 MoveNext를 호출해야 합니다.To set Current to the first element of the collection again, you can call Reset followed by MoveNext.

열거자는 컬렉션이 변경되지 않은 상태로 유지되는 한 유효한 상태를 유지합니다.An enumerator remains valid as long as the collection remains unchanged. 변경에 추가 하는 등 컬렉션을 수정 하거나 요소를 삭제, 열거자가 복구할 유효 하지 않으며을 다음에 호출할 MoveNext 또는 Reset throw는 InvalidOperationException합니다.If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to MoveNext or Reset throws an InvalidOperationException.

열거자는 컬렉션에 배타적으로 액세스하지 못하므로 컬렉션을 열거하는 것은 본질적으로 스레드로부터 안전한 프로시저가 아닙니다.The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. 열거 동안 스레드 보안을 보장하려면 전체 열거 동안 컬렉션을 잠그면 됩니다.To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. 여러 스레드에서 컬렉션에 액세스하여 읽고 쓸 수 있도록 허용하려면 사용자 지정 동기화를 구현해야 합니다.To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization.

컬렉션의 기본 구현은 System.Collections.Generic 동기화 되지 않습니다.Default implementations of collections in System.Collections.Generic are not synchronized.

이 방법은 O(1) 작업에 설명 합니다.This method is an O(1) operation.

적용 대상

추가 정보