Dictionary<TKey,TValue>.Enumerator.IEnumerator.Reset 方法

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

來源:

Dictionary.cs

設定列舉值至它的初始位置，這是在集合中第一個項目之前。

 virtual void System.Collections.IEnumerator.Reset() = System::Collections::IEnumerator::Reset;

void IEnumerator.Reset ();

abstract member System.Collections.IEnumerator.Reset : unit -> unit
override this.System.Collections.IEnumerator.Reset : unit -> unit

Sub Reset () Implements IEnumerator.Reset

實作

Reset()

例外狀況

InvalidOperationException

建立列舉值之後，集合已修改。

備註

呼叫 IEnumerator.Reset 方法之後，您必須先呼叫 MoveNext 方法，將列舉值前移至集合的第一個專案，再讀取 屬性的值 Current 。

只要集合維持不變，列舉值就仍維持有效。 如果對集合進行變更，例如加入項目或變更容量，列舉值就會無法復原，而下一次呼叫 MoveNext 或 IEnumerator.Reset 會擲回 InvalidOperationException。

僅限 .NET Core 3.0+ ：唯一不會使列舉值失效的變動方法為 Remove 和 Clear。

另請參閱

• Current
• MoveNext()
• IEnumerator