Exportar (0) Imprimir
Expandir Tudo
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

Estrutura Dictionary<TKey, TValue>.KeyCollection.Enumerator

Enumera os elementos de um Dictionary<TKey, TValue>.KeyCollection.

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

[SerializableAttribute]
public struct Enumerator : IEnumerator<TKey>, 
	IDisposable, IEnumerator

O tipo Dictionary<TKey, TValue>.KeyCollection.Enumerator expõe os membros a seguir.

  NomeDescrição
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreCurrentObtém o elemento na posição atual do enumerador.
Superior

  NomeDescrição
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDisposeLibera todos os recursos usados pela Dictionary<TKey, TValue>.KeyCollection.Enumerator.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreEqualsIndica se esta instância e oobjeto especificado são iguais. (Herdado de ValueType.)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetHashCode Retorna o hash code para essa instância. (Herdado de ValueType.)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMoveNextAvança o enumerador para o próximo elemento da Dictionary<TKey, TValue>.KeyCollection.
Método públicoCompatível com o XNA FrameworkToStringRetorna a nome de tipo totalmente qualificado desta instância. (Herdado de ValueType.)

No XNA Framework 3.0, este membro é herdado de Object.ToString().
Superior

  NomeDescrição
Implementação explícita da interfacePropriedade particularCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreIEnumerator.CurrentObtém o elemento na posição atual do enumerador.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreIEnumerator.ResetDefine o enumerador para sua posição inicial, que é antes do primeiro elemento na coleção.
Superior

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

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

Inicialmente, o enumerador está posicionado antes do primeiro elemento na coleção. Nesta posição, Current é indefinido. Portanto, 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 até que MoveNext é chamado. MoveNext define Current para o próximo elemento.

Se MoveNext passa o final da coleção, o enumerador está posicionado após o último elemento na coleção e MoveNext retorna false. Quando o enumerador está nessa posição, chamadas subseqüentes para MoveNext também retornará false. Se a última chamada para MoveNext retornou false, Current é indefinido. Não é possível definir Current para o primeiro elemento da coleção novamente. em vez disso, você deve criar uma nova instância do enumerador.

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 é irrecuperavemente invalidado e seu comportamento é indefinido.

O enumerador não tem acesso exclusivo à coleção; Portanto, enumerando através de uma coleção intrinsecamente não um procedimento de segmento-seguro. 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.

Padrão de implementações de coleções no System.Collections.Generic não estão sincronizados.

.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2015 Microsoft