IEnumeratorContract<T> Интерфейс

Определение

Перечисляет элементы в коллекции IListContract<T>.Enumerates the elements in an IListContract<T> collection.

generic <typename T>
public interface class IEnumeratorContract : IDisposable
public interface IEnumeratorContract<T> : IDisposable
type IEnumeratorContract<'T> = interface
    interface IDisposable
Public Interface IEnumeratorContract(Of T)
Implements IDisposable

Параметры типа

T

Тип перечисляемых объектов.The type of objects being enumerated.

Реализации

Комментарии

Перечислители можно использовать для чтения данных в коллекции, но они не могут использоваться для изменения коллекции.Enumerators can be used to read the data in the collection, but they cannot be used to modify the collection.

Изначально перечислитель располагается перед первым элементом коллекции.Initially, the enumerator is positioned before the first element in the collection. В этой позиции возвращаемое значение GetCurrent не определено.At this position, the return value of GetCurrent is undefined. Поэтому необходимо вызвать метод MoveNext , чтобы переместить перечислитель к первому элементу коллекции перед вызовом метода GetCurrent .Therefore, you must call MoveNext to advance the enumerator to the first element of the collection before calling GetCurrent.

GetCurrent возвращает тот же объект, пока не будет вызван метод MoveNext.GetCurrent returns the same object until MoveNext is called. MoveNextзадает возвращаемое значение GetCurrent для следующего элемента.MoveNext sets the return value of GetCurrent to the next element.

Если MoveNext передает конец коллекции, перечислитель располагается после последнего элемента в коллекции и MoveNext возвращает false .If MoveNext passes the end of the collection, the enumerator is positioned after the last element in the collection and MoveNext returns false. Если перечислитель находится в этой позиции, последующие вызовы MoveNext также возвращают false .When the enumerator is at this position, subsequent calls to MoveNext also return false. Если последний вызов MoveNext возвращен false , возвращаемое значение GetCurrent не определено.If the last call to MoveNext returned false, the return value of GetCurrent is undefined.

Перечислитель остается действительным, пока коллекция не изменяется.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 its behavior is undefined.

Методы

Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Унаследовано от IDisposable)
GetCurrent()

Возвращает объект коллекции на текущую позицию перечислителя.Returns the object in the collection at the current position of the enumerator.

MoveNext()

Перемещает перечислитель к следующему элементу коллекции.Advances the enumerator to the next element of the collection.

Reset()

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

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