MatchCollection.GetEnumerator 方法

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

傳回

一個包含所有 Match 在 內 MatchCollection的物件。

實作

例外狀況

備註

與其呼叫 GetEnumerator() 一個能讓你遍 Match 歷集合中物件的列舉子方法，不如使用你程式語言提供的集合迭代結構（例如 foreach C#）。

使用GetEnumerator()方法（或陳述式foreach）迭代 的MatchCollection成員，會使正則表達式引擎根據需要使用懶惰求值填充集合。 相較之下，正則表達式引擎在存取屬性時會直接求值，一次性填入所有 Count 集合。 這比懶惰的評估成本高得多。

由於 MatchCollection 物件通常是透過懶惰評估來填充，嘗試導航到集合的下一個成員可能會拋出 RegexMatchTimeoutException 例外。 如果匹配操作的逾時值生效，且尋找下一個匹配的嘗試超過該逾時區間，則可拋出此例外。