CaptureCollection.IEnumerable<Capture>.GetEnumerator Metodo

Definizione

Spazio dei nomi:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Source:

CaptureCollection.cs

Restituisce un enumeratore che consente di scorrere la raccolta.

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

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

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

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

Restituisce

IEnumerator<Capture>

Enumeratore che può essere usato per scorrere la raccolta.

Implementazioni

GetEnumerator()

Commenti

Il restituito IEnumerator<T> offre la possibilità 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 metodo per avanzare l'enumeratore MoveNext al primo elemento della raccolta prima di leggere il valore di Current. Current restituisce lo stesso oggetto finché non MoveNext viene chiamato di nuovo 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, 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. Se le modifiche vengono apportate alla raccolta, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi, il comportamento dell'enumeratore non è definito. Un enumeratore non ha accesso esclusivo alla raccolta, quindi un enumeratore rimane valido fino a quando la raccolta rimane invariata. Se le modifiche vengono apportate alla raccolta, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi, l'enumeratore è invalidato e si potrebbero ottenere risultati imprevisti. Inoltre, l'enumerazione di una raccolta non è una procedura thread-safe. Per garantire la sicurezza dei thread, è 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.