EventInfos.GetEnumerator メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
EventInfos コレクションに対する繰り返し処理で使用する列挙子を返します。
public:
Microsoft::SqlServer::Dts::Runtime::EventInfoEnumerator ^ GetEnumerator();public Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator GetEnumerator ();override this.GetEnumerator : unit -> Microsoft.SqlServer.Dts.Runtime.EventInfoEnumeratorPublic Function GetEnumerator () As EventInfoEnumerator戻り値
EventInfoEnumerator オブジェクト。
注釈
列挙子は、コレクションのデータを読み込むためだけに使用することを目的としています。 列挙子を使用して、基になるコレクションを変更することはできません。
列挙子は、コレクションに排他アクセスできません。
列挙子を作成すると、コレクションの現在の状態のスナップショットが作成されます。 要素の追加、変更、削除など、コレクションに変更が加えられた場合は、スナップショットが同期されない状態になり、列挙子によって InvalidOperationException がスローされます。 同時に同じコレクションから作成された列挙子でも、それぞれが持つコレクションのスナップショットが異なる場合があります。
列挙子は、コレクションの最初の要素の前に配置されていたり、コレクションの最後の要素の後ろに配置されていると、無効な状態にあります。 列挙子の状態が無効である場合、Current を呼び出すと例外がスローされます。
最初、列挙子はコレクションの先頭の要素の前に位置付けられます。 また、Reset メソッドは、列挙子を最初の位置に戻します。 そのため、列挙子を作成した後や Reset を呼び出した後は、MoveNext の値を読み取る前に Current を呼び出して、列挙子をコレクションの先頭の要素に進めておく必要があります。
Current は、MoveNext または Reset が呼び出されるまでは同じオブジェクトを返します。
コレクションの末尾を越えた場合は、列挙子はまた無効な状態となり、MoveNext を呼び出すと false が返されます。 前回 Current を呼び出して MoveNext が返された後に false を呼び出すと、例外がスローされます。