Dictionary<TKey,TValue>.KeyCollection.Enumerator Estrutura
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 de um Dictionary<TKey,TValue>.KeyCollection.
public: value class Dictionary<TKey, TValue>::KeyCollection::Enumerator : System::Collections::Generic::IEnumerator<TKey>public struct Dictionary<TKey,TValue>.KeyCollection.Enumerator : System.Collections.Generic.IEnumerator<TKey>[System.Serializable]
public struct Dictionary<TKey,TValue>.KeyCollection.Enumerator : System.Collections.Generic.IEnumerator<TKey>type Dictionary<'Key, 'Value>.KeyCollection.Enumerator = struct
interface IEnumerator<'Key>
interface IEnumerator
interface IDisposable[<System.Serializable>]
type Dictionary<'Key, 'Value>.KeyCollection.Enumerator = struct
interface IEnumerator<'Key>
interface IDisposable
interface IEnumeratorPublic Structure Dictionary(Of TKey, TValue).KeyCollection.Enumerator
Implements IEnumerator(Of TKey)Parâmetros de Tipo Genérico
- TKey
- TValue
- Herança
- Atributos
- Implementações
Observações
A afirmação foreach da linguagem C# (For Each em Visual Basic) esconde a complexidade dos enumeradores. Por isso, recomenda-se o uso foreach , em vez de manipular diretamente o enumerador.
Os enumeradores podem ser usados para ler os dados da coleção, mas não podem ser usados para modificar a coleção subjacente.
Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. Nesta posição, Current é indefinido. Deve ligar MoveNext para avançar o enumerador para o primeiro elemento da coleção antes de ler o valor de Current.
Current devolve o mesmo objeto até MoveNext ser chamado. MoveNext passa Current 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 devolvida MoveNextfalse, Current for indefinida. Não pode voltar a definir Current para o primeiro elemento da coleção; deve criar uma nova instância de enumerador em vez disso.
Um enumerador mantém-se válido enquanto a coleção permanecer inalterada. Se forem feitas alterações à coleção, como adicionar elementos ou alterar a capacidade, o enumerador é irremediavelmente invalidado e a próxima chamada para MoveNext ou IEnumerator.Reset lança um InvalidOperationException.
.NET apenas Core 3.0+: Os únicos métodos de mutação que não invalidam os enumeradores são Remove e Clear.
O enumerador não tem acesso exclusivo à coleção; Portanto, enumerar através de uma coleção não é intrinsecamente um procedimento seguro para threads. Para garantir a segurança da linha durante a enumeração, pode bloquear a coleção durante toda a enumeração. Para permitir que a coleção seja acedida por múltiplos threads para leitura e escrita, deve implementar a sua própria sincronização.
As implementações padrão das coleções em System.Collections.Generic não estão sincronizadas.
Propriedades
| Name | Description |
|---|---|
| Current |
Obtém o elemento na posição atual do enumerador. |
Métodos
| Name | Description |
|---|---|
| Dispose() |
Liberta todos os recursos utilizados pelo Dictionary<TKey,TValue>.KeyCollection.Enumerator. |
| MoveNext() |
Avança o enumerador para o próximo elemento do Dictionary<TKey,TValue>.KeyCollection. |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IEnumerator.Current |
Obtém o elemento na posição atual do enumerador. |
| IEnumerator.Reset() |
Define o enumerador para a sua posição inicial, que é antes do primeiro elemento da coleção. |