MatchCollection.GetEnumerator MatchCollection.GetEnumerator MatchCollection.GetEnumerator MatchCollection.GetEnumerator Method

定義

コレクションを反復処理する列挙子を提供します。Provides an enumerator that iterates through the collection.

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 オブジェクトを格納しているオブジェクト。An object that contains all Match objects within the MatchCollection.

実装

例外

注釈

呼び出す代わりに、GetEnumeratorを反復処理できる列挙子を取得するメソッドをMatch、コレクション内のオブジェクト グループのイテレーションの構成体を使用する必要があります (などforeach(C#) とFor Each.NextInstead of calling the GetEnumerator method to retrieve an enumerator that lets you iterate through the Match objects in the collection, you should use the group iteration construct (such as foreach in C# and For EachNext 使用するプログラミング言語によって提供される Visual Basic で)。in Visual Basic) provided by your programming language.

メンバーを反復処理、MatchCollectionオブジェクトを使用して、GetEnumeratorメソッド (またはforeach(C#) ステートメント、 For Each.Next Visual Basic でのステートメント) によりコレクションとして、必要に応じて遅延評価を使用して正規表現エンジンを設定します。Iterating the members of the MatchCollection object using the GetEnumerator method (or the foreach statement in C# and the For Each...Next statement in Visual Basic) causes the regular expression engine to populate the collection on an as needed basis using lazy evaluation. これは繰り返しの呼び出しに似ています、Regex.Matchメソッド、およびに一致した結果を追加し、MatchCollectionオブジェクト。This is analogous to repeatedly calling the Regex.Match method, and then adding the resulting match to the MatchCollection object. 正規表現エンジンは直接の評価を使用して、ときに、コレクションを一度にすべてを設定する一方、Countプロパティにアクセスします。In contrast, the regular expression engine uses direct evaluation to populate the collection all at once when the Count property is accessed. これは、遅延評価でコレクションを作成するのより高価なメソッドです。This can be a much more expensive method of building the collection than lazy evaluation.

MatchCollectionオブジェクトを作成することは一般的に遅延評価を使用すると、コレクションの次のメンバーに移動しようとしています。 スロー可能性があります、RegexMatchTimeoutException例外。Because the MatchCollection object is generally populated by using lazy evaluation, trying to navigate to the next member of the collection may throw a RegexMatchTimeoutException exception. 照合操作のタイムアウト値は実際には、次の一致を検索しようとすると、そのタイムアウト間隔を超えています。 場合、この例外をスローできます。This exception can be thrown if a time-out value for matching operations is in effect, and the attempt to find the next match exceeds that time-out interval.

適用対象