LinkedList<T>.Enumerator Estrutura

Definição

Espaço de Nomes:
System.Collections.Generic
Assemblagens:
System.dll, System.Collections.dll
Assemblagem:
System.dll
Assemblagem:
System.Collections.dll
Assemblagem:
netstandard.dll

Enumera os elementos de um LinkedList<T>.

public: value class LinkedList<T>::Enumerator : System::Collections::Generic::IEnumerator<T>
public: value class LinkedList<T>::Enumerator : System::Collections::Generic::IEnumerator<T>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public struct LinkedList<T>.Enumerator : System.Collections.Generic.IEnumerator<T>
[System.Serializable]
public struct LinkedList<T>.Enumerator : System.Collections.Generic.IEnumerator<T>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
public struct LinkedList<T>.Enumerator : System.Collections.Generic.IEnumerator<T>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type LinkedList<'T>.Enumerator = struct
    interface IEnumerator<'T>
    interface IEnumerator
    interface IDisposable
[<System.Serializable>]
type LinkedList<'T>.Enumerator = struct
    interface IEnumerator<'T>
    interface IDisposable
    interface IEnumerator
    interface ISerializable
    interface IDeserializationCallback
type LinkedList<'T>.Enumerator = struct
    interface IEnumerator<'T>
    interface IEnumerator
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable
Public Structure LinkedList(Of T).Enumerator
Implements IEnumerator(Of T)
Public Structure LinkedList(Of T).Enumerator
Implements IDeserializationCallback, IEnumerator(Of T), ISerializable

Parâmetros de Tipo Genérico

T
Herança
Object
ValueType
LinkedList<T>.Enumerator
Atributos
SerializableAttribute
Implementações
IEnumerator<T> IEnumerator IDisposable IDeserializationCallback ISerializable

Observações

A instruçã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. Portanto, deve chamar MoveNext para avançar o enumerador até ao 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, modificar ou eliminar elementos, o enumerador fica irremediavelmente invalidado e a próxima chamada para MoveNext ou IEnumerator.Reset lança um InvalidOperationException.

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 LinkedList<T>.Enumerator.
MoveNext()

Avança o enumerador para o próximo elemento do LinkedList<T>.

Implementações de Interface Explícita

Name Description
IDeserializationCallback.OnDeserialization(Object)

Implementa a ISerializable interface e levanta o evento de desserialização quando a desserialização está concluída.
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. Esta classe não pode ser herdada.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Implementa a ISerializable interface e devolve os dados necessários para serializar a LinkedList<T> instância.

Aplica-se a

Ver também