Udostępnij za pośrednictwem


SortedDictionary<TKey,TValue>.KeyCollection.Enumerator Struktura

Definicja

Wylicza elementy elementu SortedDictionary<TKey,TValue>.KeyCollection.

public: value class SortedDictionary<TKey, TValue>::KeyCollection::Enumerator : System::Collections::Generic::IEnumerator<TKey>
public struct SortedDictionary<TKey,TValue>.KeyCollection.Enumerator : System.Collections.Generic.IEnumerator<TKey>
type SortedDictionary<'Key, 'Value>.KeyCollection.Enumerator = struct
    interface IEnumerator<'Key>
    interface IEnumerator
    interface IDisposable
type SortedDictionary<'Key, 'Value>.KeyCollection.Enumerator = struct
    interface IEnumerator<'Key>
    interface IDisposable
    interface IEnumerator
Public Structure SortedDictionary(Of TKey, TValue).KeyCollection.Enumerator
Implements IEnumerator(Of TKey)

Parametry typu

TKey
TValue
Dziedziczenie
SortedDictionary<TKey,TValue>.KeyCollection.Enumerator
Implementuje

Uwagi

Instrukcja foreach języka C# (for each w języku C++, For Each w Visual Basic) ukrywa złożoność modułów wyliczania. Dlatego użycie foreach jest zalecane zamiast bezpośredniego manipulowania modułem wyliczającym.

Moduły wyliczające mogą służyć do odczytu danych w kolekcji, ale nie można za ich pomocą modyfikować kolekcji źródłowej.

Początkowo moduł wyliczający jest umieszczony przed pierwszym elementem w kolekcji. Na tym stanowisku Current jest niezdefiniowany. Przed odczytaniem wartości Currentnależy wywołać metodę MoveNext , aby przejść do pierwszego elementu kolekcji.

Właściwość Current zwraca ten sam obiekt do MoveNext momentu wywołania. MoveNext ustawia Current element na następny.

Jeśli MoveNext przejdzie koniec kolekcji, moduł wyliczający zostanie umieszczony po ostatnim elemecie w kolekcji i MoveNext zwróci wartość false. Gdy moduł wyliczający znajduje się na tym stanowisku, kolejne wywołania , aby MoveNext również zwrócić falsewartość . Jeśli ostatnie wywołanie zwracane MoveNextfalse, Current jest niezdefiniowane. Nie można ponownie ustawić Current elementu na pierwszy element kolekcji. Zamiast tego należy utworzyć nowe wystąpienie modułu wyliczającego.

Moduł wyliczający zachowuje ważność tak długo, jak długo kolekcja pozostaje niezmieniona. W przypadku wprowadzania zmian w kolekcji, takich jak dodawanie, modyfikowanie lub usuwanie elementów, moduł wyliczający jest nieodwracalnie unieważniany, a następne wywołanie MoveNext metody lub IEnumerator.Reset zgłasza InvalidOperationExceptionbłąd .

Moduł wyliczający nie ma wyłącznego dostępu do kolekcji, w związku z tym wyliczanie w kolekcji nie jest wewnętrznie procedurą odporną na wielowątkowość. Aby zagwarantować bezpieczeństwo wątków podczas wyliczania, można zablokować kolekcję podczas całego procesu wyliczania. Aby zezwolić wielu wątkom na dostęp do kolekcji w celu odczytu i zapisu danych, należy zaimplementować własny mechanizm synchronizacji.

Domyślne implementacje kolekcji w System.Collections.Generic przestrzeni nazw nie są synchronizowane.

Właściwości

Current

Pobiera element w bieżącej pozycji modułu wyliczającego.

Metody

Dispose()

Zwalnia wszelkie zasoby używane przez element SortedDictionary<TKey,TValue>.KeyCollection.Enumerator.

MoveNext()

Przechodzi do następnego elementu modułu wyliczającego SortedDictionary<TKey,TValue>.KeyCollection.

Jawne implementacje interfejsu

IEnumerator.Current

Pobiera element w bieżącej pozycji modułu wyliczającego.

IEnumerator.Reset()

Ustawia moduł wyliczający na jego pozycję początkową, która jest przed pierwszym elementem w kolekcji.

Dotyczy

Zobacz też