Condividi tramite

SortedDictionary<TKey,TValue>.ValueCollection.Enumerator Struct

  • Riferimento

Definizione

Spazio dei nomi:
System.Collections.Generic
Assembly:
System.Collections.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origine:
SortedDictionary.cs
Origine:
SortedDictionary.cs
Origine:
SortedDictionary.cs

Enumera gli elementi di un oggetto SortedDictionary<TKey,TValue>.ValueCollection.

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

Parametri di tipo

TKey
TValue
Ereditarietà
Object
ValueType
SortedDictionary<TKey,TValue>.ValueCollection.Enumerator
Implementazioni
IEnumerator<TValue> IEnumerator IDisposable

Commenti

L'istruzione foreach di C# (for each in C++, For Each in Visual Basic) nasconde la complessità degli enumeratori. Pertanto, si consiglia l'utilizzo di foreach, anziché la modifica diretta dell'enumeratore. Il tipo implementa l'interfaccia IEnumerator<T>.

È possibile utilizzare enumeratori per leggere i dati nella raccolta, ma non per modificare la raccolta sottostante.

Inizialmente l'enumeratore è posizionato davanti al primo elemento della raccolta. In questa posizione, la proprietà Current è indefinita. È necessario chiamare il MoveNext metodo per far avanzare l'enumeratore al primo elemento della raccolta prima di leggere il valore di Current.

La Current proprietà restituisce lo stesso oggetto finché non MoveNext viene chiamato . MoveNext imposta Current sull'elemento successivo.

Se MoveNext passa la fine della raccolta, l'enumeratore viene posizionato dopo l'ultimo elemento della raccolta e MoveNext restituisce false. Quando l'enumeratore si trova in questa posizione, anche le chiamate successive per MoveNext restituire false. Se l'ultima chiamata a MoveNext restituisce false, Current non è definita. Non è possibile impostare nuovamente la proprietà Current sul primo elemento della raccolta; è necessario creare una nuova istanza di enumeratore.

Un enumeratore rimane valido finché la raccolta rimane invariata. Se vengono apportate modifiche alla raccolta, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi, l'enumeratore viene invalidato in modo irreversibile e la chiamata successiva a MoveNext o IEnumerator.Reset genera un'eccezione InvalidOperationException.

L'enumeratore non dispone di accesso esclusivo alla raccolta. L'enumerazione di una raccolta non è quindi una procedura thread-safe. Per assicurare la protezione del thread durante l'enumerazione, è possibile bloccare la raccolta durante l'intera enumerazione. Per consentire l'accesso alla raccolta in lettura e scrittura da parte di più thread, è necessario implementare la propria sincronizzazione.

Le implementazioni predefinite di raccolte nello spazio dei nomi System.Collections.Generic non sono sincronizzate.

Proprietà

Current

Ottiene l'elemento in corrispondenza della posizione corrente dell'enumeratore.

Metodi

Dispose()

Rilascia tutte le risorse usate da SortedDictionary<TKey,TValue>.ValueCollection.Enumerator.
MoveNext()

Sposta l'enumeratore all'elemento successivo dell'oggetto SortedDictionary<TKey,TValue>.ValueCollection.

Implementazioni dell'interfaccia esplicita

IEnumerator.Current

Ottiene l'elemento in corrispondenza della posizione corrente dell'enumeratore.
IEnumerator.Reset()

Imposta l'enumeratore sulla propria posizione iniziale, ovvero prima del primo elemento nella raccolta.

Si applica a

Vedi anche