Reset メソッド

構文

'宣言
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()

実装

IEnumerator. . :: . .Reset() () () ()

説明

列挙子は、コレクションが変更されない限り有効です。要素の追加、変更、削除など、コレクションに変更が加えられた場合は、列挙子は無効になり回復できなくなります。そのため、次の MoveNext または Reset の呼び出しで InvalidOperationException がスローされます。

注意
Reset を呼び出した結果は、列挙子にとって常に同じ状態になる必要があります。列挙子をコレクションの先頭、つまり先頭の要素の前に移動するような実装を推奨します。そうすると、列挙子の作成後にコレクションが変更されていた場合は列挙子が無効になり、MoveNext および Current との一貫性が保たれます。

使用例

WarningEnumerator など、このコレクションから継承される任意のクラスでは、Reset を呼び出すと、インデックスがコレクションの先頭に配置されます。次のコード例は、Reset を呼び出す方法を示しています。

myEnumerator.Reset();

myEnumerator.Reset()

関連項目

参照