Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft