SortedDictionary<TKey,TValue>.GetEnumerator Metodo

Definizione

Restituisce un enumeratore che esegue l'iterazione di 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

Restituisce

Oggetto SortedDictionary<TKey,TValue>.Enumerator per SortedDictionary<TKey,TValue>.

Commenti

Ai fini dell'enumerazione, ogni elemento è una KeyValuePair<TKey,TValue> struttura che rappresenta un valore e la relativa chiave.

L'istruzione foreach del linguaggio 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.

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

Il dizionario viene mantenuto in un ordine ordinato usando un albero interno. Ogni nuovo elemento viene posizionato nella posizione di ordinamento corretta e l'albero viene modificato per mantenere l'ordine di ordinamento ogni volta che viene rimosso un elemento. Durante l'enumerazione, l'ordine di ordinamento viene mantenuto.

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

La Current proprietà restituisce lo stesso elemento finché il MoveNext metodo non 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, le chiamate successive per MoveNext restituire falseanche . Se l'ultima chiamata a MoveNext restituita 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 le modifiche vengono apportate all'insieme, 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 InvalidOperationExceptionoggetto .

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.

Questo metodo è un'operazione O(log n), dove n è conteggio.

Si applica a

Vedi anche