Export (0) Print
Expand All

IEnumerator.Reset Method

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

[Visual Basic]
Sub Reset()
[C#]
void Reset();
[C++]
void Reset();
[JScript]
function Reset();

Exceptions

Exception Type Condition
InvalidOperationException The collection was modified after the enumerator was created.

Remarks

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.

Requirements

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

Show:
© 2014 Microsoft