List<T>.Enumerator 構造体

定義

名前空間:

System.Collections.Generic

アセンブリ:

System.Collections.dll

ソース:

List.cs

List<T> の要素を列挙します。

C#

public struct List<T>.Enumerator : System.Collections.Generic.IEnumerator<T>

型パラメーター

T

継承

Object

ValueType

List<T>.Enumerator

実装

IEnumerator<T> IEnumerator IDisposable

注釈

foreach C# 言語の ステートメント (for eachC++、Visual Basic では) は、For Each列挙子の複雑さを隠します。 したがって、列挙子を直接操作するのではなく、foreach を使用することをお勧めします。

列挙子を使用すると、コレクション内のデータを読み取ることができますが、基になるコレクションを変更することはできません。

最初、列挙子はコレクションの先頭の要素の前に位置付けられます。 この位置では、Current が未定義です。 そのため、MoveNext の値を読み取る前に、Current を呼び出して列挙子をコレクションの最初の要素に進める必要があります。

Current は、MoveNext が呼び出されるまでは同じオブジェクトを返します。 MoveNext は、Current を次の要素に進めます。

MoveNext がコレクションの末尾を通過した場合、列挙子がコレクション内の最後の要素の後に配置され、MoveNext は false を返します。 列挙子がこの位置にある場合、後続の MoveNext 呼び出しも false を返します。 が返された falseCurrent の最後のMoveNext呼び出しが未定義の場合。 Current を、再度、コレクションの最初の要素に設定することはできません。列挙子の新しいインスタンスを作成する必要があります。

列挙子は、コレクションが変更されない限り有効です。 要素の追加、変更、削除など、コレクションに変更が加えられた場合、列挙子は回復不能に無効になり、次に を呼び出すかIEnumerator.Reset、 InvalidOperationExceptionをMoveNextスローします。

列挙子はコレクションに排他アクセスできないため、コレクションの列挙処理は本質的にスレッド セーフな処理ではありません。 列挙処理でスレッド セーフを確保するには、列挙処理が終わるまでコレクションをロックできます。 コレクションに対し複数のスレッドがアクセスして読み取りや書き込みを行うことができるようにするには、独自に同期化を実装する必要があります。

の System.Collections.Generic コレクションの既定の実装は同期されません。

プロパティ

Current

列挙子の現在位置の要素を取得します。

メソッド

Dispose()	List<T>.Enumerator によって使用されているすべてのリソースを解放します。
MoveNext()	列挙子を List<T> の次の要素に進めます。

明示的なインターフェイスの実装

IEnumerator.Current	列挙子の現在位置の要素を取得します。
IEnumerator.Reset()	列挙子を初期位置、つまりコレクションの最初の要素の前に設定します。

適用対象

こちらもご覧ください

• IEnumerable<T>
• IEnumerator<T>