CaptureCollection.IEnumerable<Capture>.GetEnumerator メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コレクションを反復処理する列挙子を返します。
virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Capture ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Capture ^>::GetEnumerator;
System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture> IEnumerable<Capture>.GetEnumerator ();
abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>
Function GetEnumerator () As IEnumerator(Of Capture) Implements IEnumerable(Of Capture).GetEnumerator
戻り値
コレクションの反復処理に使用できる列挙子。
実装
注釈
返される IEnumerator<T> は、 プロパティ を公開してコレクションを反復処理する機能を Current 提供します。列挙子を使用してコレクション内のデータを読み取ることができますが、コレクションを変更することはできません。
最初、列挙子はコレクションの先頭の要素の前に位置付けられます。 この位置では、Current が未定義です。 そのため、Current の値を読み取る前に、MoveNext メソッドを呼び出し、列挙子をコレクションの最初の要素に進める必要があります。
Currentは、次の要素に対する設定CurrentとしてMoveNext再度呼び出されるまでMoveNext、同じオブジェクトを返します。
MoveNext がコレクションの末尾を通過した場合、列挙子がコレクション内の最後の要素の後に配置され、MoveNext は false
を返します。 列挙子がこの位置にある場合、後続の MoveNext 呼び出しも false
を返します。 が返された false
Current の最後のMoveNext呼び出しが未定義の場合。
Current を、再度、コレクションの最初の要素に設定することはできません。列挙子の新しいインスタンスを作成する必要があります。 要素の追加、変更、削除など、コレクションに変更が加えられた場合、列挙子の動作は未定義です。
列挙子にはコレクションへの排他的アクセス権がないため、コレクションが変更されない限り、列挙子は有効なままです。 要素の追加、変更、削除など、コレクションに変更が加えられた場合、列挙子は無効になり、予期しない結果が得られる可能性があります。 また、コレクションの列挙はスレッド セーフなプロシージャではありません。 スレッド セーフを保証するには、列挙子の間にコレクションをロックするか、コレクションに同期を実装する必要があります。
名前空間内のコレクションの既定の System.Collections.Generic 実装は同期されません。
適用対象
.NET