AceEnumerator.Reset Метод

Определение

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

public:
 virtual void Reset();
public void Reset ();
abstract member Reset : unit -> unit
override this.Reset : unit -> unit
Public Sub Reset ()

Реализации

Исключения

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

Комментарии

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

Примечания для тех, кто наследует этот метод

Все вызовы Reset() должны приводить к одному и тому же состоянию перечислителя.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. Это сделает перечислитель недействительным, если коллекция была изменена с момента создания перечислителя, что согласуется с MoveNext() и Current .This invalidates the enumerator if the collection has been modified since the enumerator was created, which is consistent with MoveNext() and Current.

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