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 オブジェクトを反復処理できる列挙子を取得する代わりに、プログラミング言語 (C# のforeachなど) によって提供されるコレクション反復コンストラクトを使用する必要があります。

GetEnumerator() メソッド (または foreach ステートメント) を使用してMatchCollectionのメンバーを反復処理すると、正規表現エンジンは、遅延評価を使用して必要に応じてコレクションを設定します。 これに対し、正規表現エンジンは直接評価を使用して、 Count プロパティにアクセスしたときにコレクションを一度に設定します。 これは、遅延評価よりもはるかにコストの高い方法でコレクションを構築できます。

MatchCollection オブジェクトは通常、遅延評価を使用して設定されるため、コレクションの次のメンバーに移動しようとすると、RegexMatchTimeoutException例外がスローされる可能性があります。 この例外は、一致する操作のタイムアウト値が有効であり、次の一致の検索がタイムアウト間隔を超えた場合にスローされる可能性があります。

適用対象