IEnumeratorContract<T> Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Enumera os elementos em uma coleção 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
Parâmetros de tipo
- T
O tipo de objetos que estão sendo enumerados.
- Implementações
Comentários
Os enumeradores podem ser usados para ler os dados na coleção, mas não podem ser usados para modificar a coleção.
Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. Nessa posição, o valor retornado de GetCurrent é indefinido. Portanto, você deve chamar MoveNext para avançar o enumerador para o primeiro elemento da coleção antes de chamar GetCurrent.
GetCurrent retorna o mesmo objeto até MoveNext que seja chamado. MoveNext define o valor retornado de GetCurrent para o próximo elemento.
Caso MoveNext passe o final da coleção, o enumerador é posicionado após o último elemento na coleção e MoveNext retorna false
. Quando o enumerador está nessa posição, as chamadas subsequentes para MoveNext também retornam false
. Se a última chamada a MoveNext retornar false
, o valor retornado de GetCurrent será indefinido.
Um enumerador permanece válido desde que a coleção permaneça inalterada. Se forem feitas alterações na coleção, como adicionar, modificar ou excluir elementos, o enumerador será invalidado de maneira irrevogável e seu comportamento permanecerá indefinido.
Métodos
Dispose() |
Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de IDisposable) |
GetCurrent() |
Retorna 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 com sua posição inicial, que é antes do primeiro elemento da coleção. |