EventInfos.GetEnumerator Method

EventInfos コレクションに対する繰り返し処理で使用する列挙子を返します。

名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (microsoft.sqlserver.manageddts.dll 内)

構文

'宣言
Public Function GetEnumerator As EventInfoEnumerator

public EventInfoEnumerator GetEnumerator ()

public:
EventInfoEnumerator^ GetEnumerator ()

public EventInfoEnumerator GetEnumerator ()

public function GetEnumerator () : EventInfoEnumerator

戻り値

EventInfoEnumerator オブジェクトです。

解説

列挙子は、コレクションのデータを読み込むためだけに使用することを目的としています。列挙子を使用して、基になるコレクションを変更することはできません。

列挙子は、コレクションに排他アクセスできません。

列挙子を作成すると、コレクションの現在の状態のスナップショットが作成されます。要素の追加、変更、削除などに、コレクションの変更が加えられた場合は、スナップショットが同期されない状態になり、列挙子によって InvalidOperationException がスローされます。同時に同じコレクションから作成された列挙子でも、それぞれが持つコレクションのスナップショットが異なる場合があります。

列挙子は、コレクションの最初の要素の前に配置されていたり、コレクションの最後の要素の後ろに配置されていると、無効な状態にあります。列挙子の状態が無効である場合、Current を呼び出すと例外がスローされます。

最初、列挙子はコレクションの先頭の要素の前に配置されます。また、Reset によっても、再度この位置に列挙子が戻されます。したがって、列挙子を作成した後や Reset を実行した後は、Current の値を読み取る前に、MoveNext を呼び出して、列挙子をコレクションの先頭の要素に進めておく必要があります。

Current は、MoveNext または Reset が呼び出されるまで同じオブジェクトを返します。

コレクションの末尾に達している場合は、列挙子はまた無効な状態となり、MoveNext を呼び出すと false が返されます。MoveNext の最後の呼び出しで false が返された場合、Current を呼び出すと例外がスローされます。

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

EventInfos Class
EventInfos Members
Microsoft.SqlServer.Dts.Runtime Namespace