IEnumeratorContract<T> Interface
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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. |