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.