MatchCollection.GetEnumerator Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tillhandahåller en uppräkning som itererar genom samlingen.
public:
virtual System::Collections::IEnumerator ^ GetEnumerator();
public System.Collections.IEnumerator GetEnumerator();
abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumerator
Public Function GetEnumerator () As IEnumerator
Returer
Ett objekt som innehåller alla Match objekt i MatchCollection.
Implementeringar
Undantag
En timeout inträffade.
Kommentarer
I stället för att anropa GetEnumerator() metoden för att hämta en uppräkning som gör att du kan iterera genom objekten Match i samlingen bör du använda den samlingsiterationskonstruktion som tillhandahålls av programmeringsspråket (till exempel foreach i C#).
Om du itererar medlemmarna i metoden GetEnumerator() (eller -instruktionenforeach) fylls samlingen efter behov med hjälp av MatchCollection lat utvärdering. Däremot använder motorn för reguljära uttryck direktutvärdering för att fylla i samlingen samtidigt när Count egenskapen används. Detta kan vara en mycket dyrare metod för att skapa samlingen än lat utvärdering.
Eftersom objektet MatchCollection vanligtvis fylls i med hjälp av lat utvärdering kan ett undantag uppstå RegexMatchTimeoutException när du försöker navigera till nästa medlem i samlingen. Det här undantaget kan utlöses om ett timeout-värde för matchande åtgärder tillämpas och försöket att hitta nästa matchning överskrider tidsgränsintervallet.