DtsEnumerator.Reset メソッド
列挙子を、最初の位置である、コレクションの先頭の要素の前に設定します。
名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)
構文
'宣言
Public Sub Reset
'使用
Dim instance As DtsEnumerator
instance.Reset()
public void Reset()
public:
virtual void Reset() sealed
abstract Reset : unit -> unit
override Reset : unit -> unit
public final function Reset()
実装
説明
列挙子は、コレクションが変更されない限り有効です。 要素の追加、変更、削除など、コレクションに変更が加えられた場合は、列挙子は無効になり回復できなくなります。そのため、次の MoveNext または Reset の呼び出しで InvalidOperationException がスローされます。
.gif "注意") 注 |
|---|
Reset を呼び出した結果は、列挙子にとって常に同じ状態になる必要があります。 列挙子をコレクションの先頭、つまり先頭の要素の前に移動するような実装を推奨します。 そうすると、列挙子の作成後にコレクションが変更されていた場合は列挙子が無効になり、MoveNext および Current との一貫性が保たれます。 |
使用例
WarningEnumerator など、このコレクションから継承される任意のクラスでは、Reset を呼び出すと、インデックスがコレクションの先頭に配置されます。 次のコード例は、Reset を呼び出す方法を示しています。
myEnumerator.Reset();
myEnumerator.Reset()