SortedDictionary<TKey,TValue>.GetEnumerator 메서드

정의

네임스페이스:

System.Collections.Generic

어셈블리:

System.Collections.dll

Source:

SortedDictionary.cs

SortedDictionary<TKey,TValue>를 반복하는 열거자를 반환합니다.

public:
 System::Collections::Generic::SortedDictionary<TKey, TValue>::Enumerator GetEnumerator();

public System.Collections.Generic.SortedDictionary<TKey,TValue>.Enumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.Generic.SortedDictionary<'Key, 'Value>.Enumerator

Public Function GetEnumerator () As SortedDictionary(Of TKey, TValue).Enumerator

반환

SortedDictionary<TKey,TValue>.Enumerator

SortedDictionary<TKey,TValue>.Enumerator에 대한 SortedDictionary<TKey,TValue>입니다.

설명

열거형을 위해 각 항목은 값과 해당 키를 나타내는 구조체입니다 KeyValuePair<TKey,TValue> .

C# 언어for each(C++, For Each Visual Basic의 경우)의 문은 foreach 열거자의 복잡성을 숨깁니다. 그러므로 열거자를 직접 조작하는 대신 foreach를 사용하는 것이 좋습니다.

열거자를 사용하여 컬렉션의 데이터를 읽을 수는 있지만 내부 컬렉션을 수정할 수는 없습니다.

사전은 내부 트리를 사용하여 정렬된 순서로 유지 관리됩니다. 모든 새 요소는 올바른 정렬 위치에 배치되고 요소가 제거될 때마다 정렬 순서를 유지하도록 트리가 조정됩니다. 열거하는 동안 정렬 순서가 유지됩니다.

처음에 열거자는 컬렉션의 첫 번째 요소 앞에 배치됩니다. 이 위치에 Current 속성 정의 되지 않습니다. 따라서 호출 해야 합니다 MoveNext 해당 열거자의 값을 읽기 전에 컬렉션의 첫 번째 요소를 이동 하는 방법 Current합니다.

속성은 Current 메서드가 호출될 때까지 MoveNext 동일한 요소를 반환합니다. MoveNext는 Current를 다음 요소로 설정합니다.

경우 MoveNext 열거자를 컬렉션의 끝 컬렉션의 마지막 요소 뒤에 배치 되는 전달 하 고 MoveNext 반환 false합니다. 열거자가 있는 경우이 위치에 대 한 후속 호출은 MoveNext 반환할 수도 false합니다. 반환 falseCurrent 된 에 대한 MoveNext 마지막 호출이 정의되지 않은 경우 Current를 컬렉션의 첫 번째 요소로 다시 설정할 수 없으므로 대신 새 열거자 인스턴스를 만들어야 합니다.

컬렉션이 변경되지 않고 그대로 유지되는 한 열거자는 유효한 상태로 유지됩니다. 변경에 추가 하는 등 컬렉션을 수정 하거나 요소를 삭제, 열거자가 복구할 유효 하지 않으며을 다음에 호출할 MoveNext 또는 IEnumerator.Reset throw는 InvalidOperationException합니다.

열거자는 컬렉션에 배타적으로 액세스하지 못하므로 컬렉션을 열거하는 것은 본질적으로 스레드로부터 안전한 프로시저가 아닙니다. 열거 동안 스레드 보안을 보장하려면 전체 열거 동안 컬렉션을 잠그면 됩니다. 여러 스레드에서 컬렉션에 액세스하여 읽고 쓸 수 있도록 허용하려면 사용자 지정 동기화를 구현해야 합니다.

System.Collections.Generic 네임스페이스에서 컬렉션의 기본 구현은 동기화되지 않습니다.

이 메서드는 O(log n) 작업이며 여기서 n은 count입니다.

추가 정보

• SortedDictionary<TKey,TValue>.Enumerator
• IEnumerator<T>