GetEnumerator Método
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método Stack.GetEnumerator ()

 

Retorna IEnumerator para Stack.

Namespace:   System.Collections
Assembly:  mscorlib (em mscorlib.dll)

public virtual IEnumerator GetEnumerator()

Valor de retorno

Type: System.Collections.IEnumerator

IEnumerator para Stack.

[Basic, Visual C#]

A instrução de foreach de linguagem C# (for each no Visual Basic) ocultar a complexidade dos enumeradores. Em virtude disso, usar foreach é recomendável, em vez de diretamente manipular o enumerador.

Os enumeradores podem ser usados para ler os dados na coleção, mas não podem ser usados para alterar a coleção subjacente.

Inicialmente, o enumerador está posicionado antes do primeiro elemento na coleção. Reset também coloca o enumerador de volta para essa posição. Nessa posição, Current é indefinido.Em virtude disso, você deve chamar MoveNext para avançar o enumerador para o primeiro elemento da coleção antes de ler o valor de Current.

Current retorna o mesmo objeto ou até MoveNext ou Reset é chamado.conjuntos Current deMoveNext para o próximo elemento.

Se MoveNext passa ao final da coleção, o enumerador estiver posicionado depois que o elemento o último da coleção e em MoveNext retorna false.Quando o enumerador estiver nessa posição, chamadas subsequentes de MoveNext a ser retornado falsetambém.Se a última chamada para MoveNext retornado false, Current é indefinido.Para definir novamente Current ao primeiro elemento da coleção, você pode chamar Reset seguido por MoveNext.

Um enumerador permanece válido, desde que a coleção permaneça inalterada.Se as alterações forem feitas à coleção, tais como adicionar, modificar ou excluir elementos, o enumerador é irrecuperavelmente invalidado e seu comportamento é indefinido.

O enumerador não tiver acesso exclusivo na coleção; consequentemente, enumerar através de uma coleção não será intrinsecamente um procedimento thread-safe. Para garantir segurança de segmentos durante enumeração, você pode bloquear a coleção durante toda a enumeração. Para permitir que a coleção seja acessada por vários segmentos de leitura e gravação, você deve implementar sua sincronização.

Este método é uma operação de (1).

Universal Windows Platform
Disponível desde 10
.NET Framework
Disponível desde 1.1
Retornar ao topo
Mostrar:
© 2016 Microsoft