DbEnumerator.Current Propriedade

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbEnumerator.cs

Obtém o elemento atual na coleção.

public:
 property System::Object ^ Current { System::Object ^ get(); };

public object Current { get; }

member this.Current : obj

Public ReadOnly Property Current As Object

Valor da propriedade

Object

O elemento atual da coleção.

Implementações

Current

Exceções

InvalidOperationException

O enumerador é posicionado antes do primeiro elemento da coleção ou depois do último elemento.

Comentários

Depois que um enumerador é criado ou após um Reset, MoveNext deve ser chamado para avançar o enumerador para o primeiro elemento da coleção antes de ler o valor de Current; caso contrário, Current é indefinido. Current também gerará uma exceção se a última chamada para MoveNext retornar false, o que indica o fim da coleção. Current não move a posição do enumerador e chamadas consecutivas para Current retornar o mesmo objeto até MoveNext ou Reset ser chamado. 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. Se a coleção for modificada entre MoveNext e Current, Current retornará o elemento ao qual está definida, mesmo que o enumerador já esteja invalidado.

Confira também

• Visão geral do ADO.NET