MatchCollection.GetEnumerator Metodo
Definizione
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.
Fornisce un enumeratore che scorre la raccolta.
public:
virtual System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator();abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorValori restituiti
Oggetto che contiene tutti gli Match oggetti all'interno di MatchCollection.
Implementazioni
Eccezioni
Si è verificato un timeout.
Commenti
Anziché chiamare il GetEnumerator() metodo per recuperare un enumeratore che consente di scorrere gli Match oggetti nella raccolta, è consigliabile usare il costrutto di iterazione della raccolta fornito dal linguaggio di programmazione, ad esempio foreach in C#.
L'iterazione dei membri dell'oggetto MatchCollection utilizzando il GetEnumerator() metodo (o l'istruzione foreach ) fa sì che il motore delle espressioni regolari popola la raccolta in base alle esigenze usando la valutazione differita. Al contrario, il motore delle espressioni regolari usa la valutazione diretta per popolare la raccolta contemporaneamente quando si accede alla Count proprietà. Questo può essere un metodo molto più costoso di compilazione della raccolta rispetto alla valutazione differita.
Poiché l'oggetto MatchCollection viene in genere popolato tramite la valutazione differita, il tentativo di passare al membro successivo della raccolta potrebbe generare un'eccezione RegexMatchTimeoutException . Questa eccezione può essere generata se è attivo un valore di timeout per le operazioni di corrispondenza e il tentativo di trovare la corrispondenza successiva supera l'intervallo di timeout.
