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.

[Visual Basic]
Sub Reset()
void Reset();
void Reset();
function Reset();


Exception Type 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 MoveNext or Reset throws an InvalidOperationException.

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.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

IEnumerator Interface | IEnumerator Members | System.Collections Namespace | MoveNext | Current

© 2015 Microsoft