SortedDictionary<TKey,TValue>.Enumerator Struktura

Definice

Obor názvů:

System.Collections.Generic

Sestavení:

netstandard.dll, System.Collections.dll

Zdroj:

SortedDictionary.cs

Vytvoří výčet prvků objektu SortedDictionary<TKey,TValue>.

public: value class SortedDictionary<TKey, TValue>::Enumerator : System::Collections::Generic::IEnumerator<System::Collections::Generic::KeyValuePair<TKey, TValue>>, System::Collections::IDictionaryEnumerator

public struct SortedDictionary<TKey,TValue>.Enumerator : System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<TKey,TValue>>, System.Collections.IDictionaryEnumerator

type SortedDictionary<'Key, 'Value>.Enumerator = struct
    interface IEnumerator<KeyValuePair<'Key, 'Value>>
    interface IEnumerator
    interface IDisposable
    interface IDictionaryEnumerator

Public Structure SortedDictionary(Of TKey, TValue).Enumerator
Implements IDictionaryEnumerator, IEnumerator(Of KeyValuePair(Of TKey, TValue))

Parametry typu

TKey

TValue

Dědičnost

Object

ValueType

SortedDictionary<TKey,TValue>.Enumerator

Implementuje

IEnumerator<KeyValuePair<TKey,TValue>> IDictionaryEnumerator IEnumerator IDisposable

Poznámky

Příkaz foreach jazyka C# (For Each v jazyce 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.

Na začátku je enumerátor umístěn před prvním prvkem v kolekci. V této pozici Current není definováno. Před čtením hodnoty Currentje nutné volat metodu MoveNext pro přechod enumerátoru na první prvek kolekce .

Tato Current vlastnost 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í vrátit MoveNext také 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 IEnumerator.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í v System.Collections.Generic oboru názvů nejsou synchronizovány.

Vlastnosti

Name	Description
Current	Získá prvek na aktuální pozici enumerátoru.

Metody

Name	Description
Dispose()	Uvolní všechny prostředky používané nástrojem SortedDictionary<TKey,TValue>.Enumerator.
MoveNext()	Přejde enumerátor na další prvek objektu SortedDictionary<TKey,TValue>.

Explicitní implementace rozhraní

Name	Description
IDictionaryEnumerator.Entry	Získá prvek na aktuální pozici enumerátoru jako DictionaryEntry strukturu.
IDictionaryEnumerator.Key	Získá klíč prvku na aktuální pozici enumerátoru.
IDictionaryEnumerator.Value	Získá hodnotu prvku na aktuální pozici enumerátoru.
IEnumerator.Current	Získá prvek na aktuální pozici enumerátoru.
IEnumerator.Reset()	Nastaví enumerátor na počáteční pozici, která je před prvním prvkem v kolekci.

Viz také

• SortedDictionary<TKey,TValue>.KeyCollection.Enumerator
• SortedDictionary<TKey,TValue>.ValueCollection.Enumerator
• IEnumerable<T>
• IEnumerator<T>