HashSet<T>.Enumerator Struct
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Enumera gli elementi di un oggetto HashSet<T>.
public: value class HashSet<T>::Enumerator : System::Collections::Generic::IEnumerator<T>
public struct HashSet<T>.Enumerator : System.Collections.Generic.IEnumerator<T>
[System.Serializable]
public struct HashSet<T>.Enumerator : System.Collections.Generic.IEnumerator<T>
type HashSet<'T>.Enumerator = struct
interface IEnumerator<'T>
interface IEnumerator
interface IDisposable
[<System.Serializable>]
type HashSet<'T>.Enumerator = struct
interface IEnumerator<'T>
interface IDisposable
interface IEnumerator
Public Structure HashSet(Of T).Enumerator
Implements IEnumerator(Of T)
- T
- Ereditarietà
- Attributi
- Implementazioni
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.
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 proprietà Current restituisce lo stesso oggetto finché non viene chiamato il metodo MoveNext. 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 false
anche . Se l'ultima chiamata a MoveNext restituita false
è Current non definita. Non è possibile impostare Current di nuovo sul primo elemento della raccolta. È necessario creare invece un nuovo oggetto 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.
Current |
Ottiene l'elemento in corrispondenza della posizione corrente dell'enumeratore. |
Dispose() |
Rilascia tutte le risorse utilizzate da un oggetto HashSet<T>.Enumerator. |
Move |
Sposta l'enumeratore all'elemento successivo della raccolta HashSet<T>. |
IEnumerator. |
Ottiene l'elemento in corrispondenza della posizione corrente dell'enumeratore. |
IEnumerator. |
Imposta l'enumeratore sulla propria posizione iniziale, ovvero prima del primo elemento nella raccolta. |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: