MatchCollection.IEnumerable<Match>.GetEnumerator Metodo

Definizione

Spazio dei nomi:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Origine:

MatchCollection.cs

Restituisce un enumeratore che consente di scorrere la raccolta.

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>

Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumerator

Restituisce

IEnumerator<Match>

Enumeratore che può essere usato per scorrere la raccolta.

Implementazioni

GetEnumerator()

Eccezioni

NotSupportedException

Raccolta in sola lettura.

Commenti

L'oggetto restituito IEnumerator<T> consente di scorrere l'insieme esponendo una Current proprietà . È possibile usare enumeratori per leggere i dati in una raccolta, ma non per modificare la raccolta. Inizialmente l'enumeratore è posizionato davanti al primo elemento della raccolta. In questa posizione, la proprietà Current è indefinita. Pertanto, è necessario chiamare il MoveNext metodo per far avanzare l'enumeratore al primo elemento della raccolta prima di leggere il valore di Current. Current restituisce lo stesso oggetto finché non MoveNext viene chiamato nuovamente come MoveNext impostato 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. Se vengono apportate modifiche alla raccolta, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi, il comportamento dell'enumeratore non è definito. Un enumeratore non dispone dell'accesso esclusivo alla raccolta, pertanto 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 e si potrebbero ottenere risultati imprevisti. Inoltre, l'enumerazione di una raccolta non è una procedura thread-safe. Per garantire la thread-safety, è necessario bloccare la raccolta durante l'enumeratore o implementare la sincronizzazione nella raccolta. Le implementazioni predefinite delle raccolte nello System.Collections.Generic spazio dei nomi non vengono sincronizzate.