Reset Method
Collapse the table of content
Expand the table of content

IEnumerator.Reset Method ()

 

Sets the enumerator to its initial position, which is before the first element in the collection.

Namespace:   System.Collections
Assembly:  mscorlib (in mscorlib.dll)

abstract Reset : unit -> unit

Exception Condition
InvalidOperationException

The collection was modified after the enumerator was created.

An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to the MoveNext or Reset method throws an InvalidOperationException.

The Reset method is provided for COM interoperability. It does not necessarily need to be implemented; instead, the implementer can simply throw a NotSupportedException.

Notes to Implementers:

All calls to Reset must result in the same state for the enumerator. The preferred implementation is to move the enumerator to the beginning of the collection, before the first element. This invalidates the enumerator if the collection has been modified since the enumerator was created, which is consistent with MoveNext and Current.

The following code example demonstrates the implementation of the IEnumerator interfaces for a custom collection. In this example, Reset is not explicitly called, but it is implemented to support the use of foreach (for each in Visual Basic). This code example is part of a larger example for the IEnumerator interface.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show:
© 2016 Microsoft