SortedList<TKey,TValue>.GetEnumerator Método

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Origem:

SortedList.cs

Retorna um enumerador que itera por meio de SortedList<TKey,TValue>.

public:
 System::Collections::Generic::IEnumerator<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ GetEnumerator();

public System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<TKey,TValue>> GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<'Key, 'Value>>

Public Function GetEnumerator () As IEnumerator(Of KeyValuePair(Of TKey, TValue))

Retornos

IEnumerator<KeyValuePair<TKey,TValue>>

Um IEnumerator<T> do tipo KeyValuePair<TKey,TValue> para SortedList<TKey,TValue>.

Implementações

GetEnumerator()

Comentários

A instrução foreach da linguagem C# (for each no C++, For Each no Visual Basic) oculta a complexidade dos enumeradores. Portanto, o uso de foreach é recomendado, em vez de manipular diretamente o enumerador.

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

O dicionário é mantido em uma ordem classificada usando uma árvore interna. Cada novo elemento é posicionado na posição de classificação correta e a árvore é ajustada para manter a ordem de classificação sempre que um elemento é removido. Durante a enumeração, a ordem de classificação é mantida.

Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. Nesta posição, Current está indefinido. Por isso, você deve chamar MoveNext para avançar o enumerador até o primeiro elemento da coleção antes de ler o valor de Current.

Current retorna o mesmo objeto até MoveNext que seja chamado. MoveNext define Current como 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, chamadas subsequentes para MoveNext retornar false. Caso a última chamada para MoveNext tenha retornado false, Current está indefinido. Não é possível definir Current como o primeiro elemento da coleção novamente; você deve criar uma nova instância de enumerador em vez disso.

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 irrecuperavelmente e a próxima chamada para MoveNext ou Reset gerará um InvalidOperationException.

O enumerador não tem acesso exclusivo à coleção; por isso, a enumeração por meio de uma coleção não é um procedimento thread-safe intrínseco. Para garantir acesso thread-safe durante a enumeração, é possível bloquear a coleção durante toda a enumeração. Para permitir que a coleção seja acessada por vários threads para leitura e gravação, você deve implementar sua própria sincronização.

As implementações padrão de coleções em System.Collections.Generic não são sincronizadas.

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

Confira também

• IEnumerator<T>