SortedList<TKey,TValue>.GetEnumerator Metoda

Definice

Obor názvů:

System.Collections.Generic

Sestavení:

netstandard.dll, System.Collections.dll

Zdroj:

SortedList.cs

Vrátí enumerátor, který iteruje přes SortedList<TKey,TValue>.

public:
 System::Collections::Generic::IEnumerator<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ GetEnumerator();

public System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<TKey,TValue>> GetEnumerator();

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

Public Function GetEnumerator () As IEnumerator(Of KeyValuePair(Of TKey, TValue))

Návraty

IEnumerator<KeyValuePair<TKey,TValue>>

Typ IEnumerator<T>KeyValuePair<TKey,TValue> pro SortedList<TKey,TValue>.

Implementuje

GetEnumerator()

Poznámky

Příkaz foreach jazyka C# (For Each v Visual Basic) skryje složitost výčtů. Proto se místo přímé manipulace s enumerátorem doporučuje použití foreach .

Enumerátory lze použít ke čtení dat v kolekci, ale nelze je použít k úpravě podkladové kolekce.

Slovník se udržuje v seřazeném pořadí pomocí interního stromu. Každý nový prvek je umístěn na správné pozici řazení a strom je upraven tak, aby zachoval pořadí řazení při každém odebrání prvku. Při vytváření výčtu je zachováno pořadí řazení.

Na začátku je enumerátor umístěn před prvním prvkem v kolekci. V této pozici Current není definováno. Proto je nutné volat MoveNext , aby se enumerátor před čtením hodnoty Current.

Current vrátí stejný objekt, dokud MoveNext nebude volána. MoveNext nastaví Current na další prvek.

Pokud MoveNext předá konec kolekce, enumerátor je umístěn za posledním prvkem v kolekci a MoveNext vrátí .false Pokud je enumerátor na této pozici, následné volání k MoveNext vrácení false. Pokud se vrátí poslední volání MoveNextfalse, Current není definováno. Znovu nelze nastavit Current první prvek kolekce. Místo toho je nutné vytvořit novou instanci enumerátoru.

Enumerátor zůstane platný, dokud kolekce zůstane beze změny. Pokud jsou v kolekci provedeny změny, například přidání, úpravy nebo odstranění prvků, enumerátor je nenávratně neplatný a další volání MoveNext nebo Reset vyvolá výjimku InvalidOperationException.

Enumerátor nemá výhradní přístup k kolekci; proto výčet prostřednictvím kolekce není vnitřně bezpečným postupem pro přístup z více vláken. Chcete-li zaručit bezpečnost vláken během výčtu, můžete kolekci uzamknout během celého výčtu. Pokud chcete povolit přístup ke kolekci více vlákny pro čtení a zápis, musíte implementovat vlastní synchronizaci.

Výchozí implementace kolekcí nejsou System.Collections.Generic synchronizovány.

Tato metoda je operace O(1).

Viz také

• IEnumerator<T>