Dictionary<TKey,TValue>.Enumerator.IEnumerator.Reset Метод

Определение

Устанавливает перечислитель в его начальное положение, т. е. перед первым элементом коллекции.Sets the enumerator to its initial position, which is before the first element in the collection.

 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

Реализации

Исключения

После создания перечислителя семейство было изменено.The collection was modified after the enumerator was created.

Комментарии

После вызова IEnumerator.Reset метода необходимо вызвать MoveNext метод, чтобы переместить перечислитель к первому элементу коллекции перед считыванием значения Current Свойства.After calling the IEnumerator.Reset method, you must call the MoveNext method to advance the enumerator to the first element of the collection before reading the value of the Current property.

Перечислитель является допустимым до тех пор, пока коллекция остается неизменной.An enumerator remains valid as long as the collection remains unchanged. Если в коллекцию вносятся изменения, например добавление элементов или изменение емкости, перечислитель становится необратимо недействительным, а следующий вызов MoveNext или IEnumerator.Reset вызывает исключение InvalidOperationException .If changes are made to the collection, such as adding elements or changing the capacity, the enumerator is irrecoverably invalidated and the next call to MoveNext or IEnumerator.Reset throws an InvalidOperationException.

Только .NET Core 3.0 +: единственными изменяющимися методами, которые не являются недопустимыми перечислителями, являются Remove и Clear ..NET Core 3.0+ only: The only mutating methods which do not invalidate enumerators are Remove and Clear.

Применяется к

См. также раздел