MatchCollection.Item[Int32] プロパティ

定義

コレクションの個々のメンバーを取得します。

public:
 virtual property System::Text::RegularExpressions::Match ^ default[int] { System::Text::RegularExpressions::Match ^ get(int i); };
public virtual System.Text.RegularExpressions.Match this[int i] { get; }
member this.Item(int) : System.Text.RegularExpressions.Match
Default Public Overridable ReadOnly Property Item(i As Integer) As Match

パラメーター

i
Int32

Match コレクションにインデックスを作成します。

プロパティ値

コレクション内の i 位置にキャプチャされた部分文字列。

実装

例外

i が 0 未満か、 Count以上です。

タイムアウトが発生しました。

注釈

C# では、 Item[Int32] プロパティはインデクサーです。コード内で明示的に参照されるのではなく、配列であるかのように MatchCollection にアクセスできます。

通常、 MatchCollection 内の個々の項目は、コレクション内の項目の合計数が Count プロパティから決定された後にのみ、インデックスによってアクセスされます。 ただし、 Count プロパティにアクセスすると、正規表現エンジンは直接評価を使用してコレクションを一度にビルドします。 これは通常、 GetEnumerator() メソッドまたは foreach ステートメントを使用してコレクションを反復処理するよりもコストがかかります。

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

適用対象

こちらもご覧ください