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.EventInfoEnumerator
Public Function GetEnumerator () As EventInfoEnumerator
戻り値
EventInfoEnumerator オブジェクト。
注釈
列挙子は、コレクションのデータを読み込むためだけに使用することを目的としています。 列挙子を使用して、基になるコレクションを変更することはできません。
列挙子は、コレクションに排他アクセスできません。
列挙子を作成すると、コレクションの現在の状態のスナップショットが作成されます。 要素の追加、変更、削除など、コレクションに変更が加えられた場合は、スナップショットが同期されない状態になり、列挙子によって InvalidOperationException
がスローされます。 同時に同じコレクションから作成された列挙子でも、それぞれが持つコレクションのスナップショットが異なる場合があります。
列挙子は、コレクションの最初の要素の前に配置されていたり、コレクションの最後の要素の後ろに配置されていると、無効な状態にあります。 列挙子の状態が無効である場合、Current
を呼び出すと例外がスローされます。
最初、列挙子はコレクションの先頭の要素の前に位置付けられます。 また、Reset
メソッドは、列挙子を最初の位置に戻します。 そのため、列挙子を作成した後や Reset
を呼び出した後は、MoveNext
の値を読み取る前に Current
を呼び出して、列挙子をコレクションの先頭の要素に進めておく必要があります。
Current
は、MoveNext
または Reset
が呼び出されるまでは同じオブジェクトを返します。
コレクションの末尾を越えた場合は、列挙子はまた無効な状態となり、MoveNext
を呼び出すと false
が返されます。 前回 Current
を呼び出して MoveNext
が返された後に false
を呼び出すと、例外がスローされます。