IEnumeratorContract<T> Interface

Definição

Enumera os elementos numa IListContract<T> coleção.

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

Parâmetros de Tipo Genérico

T

O tipo de objetos que estão a ser enumerados.

Implementações

Observações

Os enumeradores podem ser usados para ler os dados da coleção, mas não podem ser usados para modificar a coleção.

Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. Nesta posição, o valor de retorno de GetCurrent é indefinido. Por isso, deve ligar MoveNext para avançar o enumerador para o primeiro elemento da coleção antes de chamar GetCurrent.

GetCurrent devolve o mesmo objeto até MoveNext ser chamado. MoveNext define o valor de retorno GetCurrent para o elemento seguinte.

Se MoveNext passar o final da coleção, o enumerador é posicionado após o último elemento da coleção e MoveNext retorna false. Quando o enumerador está nesta posição, chamadas subsequentes também MoveNext retornam false. Se a última chamada para MoveNext devolvida false, o valor de retorno de GetCurrent é indefinido.

Um enumerador mantém-se válido enquanto a coleção permanecer inalterada. Se forem feitas alterações à coleção, como adicionar, modificar ou eliminar elementos, o enumerador fica irremediavelmente invalidado e o seu comportamento é indefinido.

Métodos

Name Description
Dispose()

Realiza tarefas definidas pela aplicação associadas à libertação, libertação ou reinício de recursos não geridos.

(Herdado de IDisposable)
GetCurrent()

Devolve o objeto na coleção na posição atual do enumerador.

MoveNext()

Avança o enumerador para o próximo elemento da coleção.

Reset()

Define o enumerador para a sua posição inicial, que é antes do primeiro elemento da coleção.

Aplica-se a