EventInfos.GetEnumerator Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um enumerador para uso na iteração pela coleção EventInfos.
public:
Microsoft::SqlServer::Dts::Runtime::EventInfoEnumerator ^ GetEnumerator();
public Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator GetEnumerator ();
override this.GetEnumerator : unit -> Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator
Public Function GetEnumerator () As EventInfoEnumerator
Retornos
Um objeto EventInfoEnumerator.
Comentários
Os enumeradores devem ser usados apenas para ler dados na coleção. Os enumeradores não podem ser usados para modificar a coleção subjacente.
O enumerador não tem acesso exclusivo à coleção.
Quando um enumerador é criado, ele usa um instantâneo do estado atual da coleção. Se forem feitas alterações na coleção, como adicionar, modificar ou excluir elementos, o instantâneo sairá da sincronização e o enumerador gerará um InvalidOperationException
. Dois enumeradores criados da mesma coleção ao mesmo tempo podem ter instantâneos diferentes da coleção.
O enumerador está em um estado que não é válido se ele é posicionado antes do primeiro elemento na coleção ou depois do último elemento na coleção. Sempre que o enumerador está em um estado que não é válido, a chamada Current
gera uma exceção.
Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. Reset
também traz o enumerador de volta para essa posição. Portanto, depois que um enumerador é criado ou depois Reset
, MoveNext
deve ser chamado 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é MoveNext
ou Reset
ser chamado.
Depois que o final da coleção é passado, o enumerador está novamente em um estado que não é válido e a chamada MoveNext
retorna false
. A chamada Current
gera uma exceção se a última chamada a ser MoveNext
retornada false
.