IEnumeratorContract<T> Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перечисляет элементы в коллекции IListContract<T>.
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
Тип перечисляемых объектов.
- Реализации
Комментарии
Перечислители можно использовать для чтения данных в коллекции, но они не могут использоваться для изменения коллекции.
Изначально перечислитель располагается перед первым элементом коллекции. В этой позиции возвращаемое значение GetCurrent не определено. Поэтому необходимо вызвать метод MoveNext , чтобы переместить перечислитель к первому элементу коллекции перед вызовом метода GetCurrent .
GetCurrent возвращает тот же объект, пока не будет вызван метод MoveNext. MoveNext задает возвращаемое значение GetCurrent для следующего элемента.
Если MoveNext передает конец коллекции, перечислитель располагается после последнего элемента в коллекции и MoveNext возвращает false
. Если перечислитель находится в этой позиции, последующие вызовы MoveNext также возвращают false
. Если последний вызов MoveNext возвращен false
, возвращаемое значение GetCurrent не определено.
Перечислитель является допустимым до тех пор, пока коллекция остается неизменной. Если в коллекцию вносятся изменения, например добавляются, изменяются или удаляются элементы, перечислитель становится недействительным без возможности восстановление, а его поведение не определено.
Методы
Dispose() |
Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable) |
GetCurrent() |
Возвращает объект коллекции на текущую позицию перечислителя. |
MoveNext() |
Перемещает перечислитель к следующему элементу коллекции. |
Reset() |
Устанавливает перечислитель в его начальное положение, т. е. перед первым элементом коллекции. |