BreakpointTargetEnumerator クラス

定義

public ref class BreakpointTargetEnumerator sealed : Microsoft::SqlServer::Dts::Runtime::DtsEnumerator

public sealed class BreakpointTargetEnumerator : Microsoft.SqlServer.Dts.Runtime.DtsEnumerator

type BreakpointTargetEnumerator = class
    inherit DtsEnumerator

Public NotInheritable Class BreakpointTargetEnumerator
Inherits DtsEnumerator

継承

Object

DtsEnumerator

BreakpointTargetEnumerator

注釈

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

最初は、列挙子はコレクション内の最初の要素の前に配置されます。 Reset メソッドは、列挙子もこの位置に戻します。 この位置で、 Current プロパティを呼び出すと例外がスローされます。 したがって、列挙子をコレクションの最初の要素に進める方法を呼び出す必要があります MoveNext 、その後に Currentの値を読み取る必要があります。

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

コレクションの末尾が渡されると、列挙子はコレクション内の最後の要素の後に配置され、 MoveNext を呼び出すと falseが返されます。 MoveNextの最後の呼び出しがfalse返された場合、Current呼び出しは例外をスローします。 Currentをコレクションの最初の要素に再度設定するには、Resetを呼び出し、その後にMoveNextを呼び出します。

列挙子は、コレクションが変更されない限り有効なままです。 コレクションに要素の追加、修正、削除などの変更が加えられると、列挙子は無効化され回復不能になります。したがって、次に MoveNext または Reset にコールすると InvalidOperationExceptionが投げられます。 しかし、コレクションが MoveNext と Currentの間で修正された場合、列挙子が無効になっていても、 Current は設定元の要素を返します。

列挙者はコレクションに対して排他的なアクセス権を持ちません。したがって、コレクションを通じた列挙はスレッドセーフな手順ではありません。 コレクションが同期されている場合でも、他のスレッドがコレクションを変更して、列挙子が例外をスローする可能性があります。 列挙中のスレッド セーフを保証するには、列挙全体の間にコレクションをロックするか、他のスレッドによって行われた変更によって発生する例外をキャッチします。