IDTSExternalMetadataColumnCollection100.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.
public:
System::Collections::IEnumerator ^ GetEnumerator();[System.Runtime.InteropServices.DispId(-4)]
public System.Collections.IEnumerator GetEnumerator ();[<System.Runtime.InteropServices.DispId(-4)>]
abstract member GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRetornos
Um System.Collections.Generic.IEnumerator que pode iterar pela coleção da coluna de metadados externa.
Implementações
- Atributos
Comentários
Os enumeradores permitem somente a leitura dos dados na coleção. Enumeradores não podem ser usados para modificar a coleção subjacente.
Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. Redefinir também leva o enumerador de volta para essa posição. Nesta posição, a chamada atual gera uma exceção. 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 ou Reset seja chamado. MoveNext define o atual como o próximo elemento.
Depois que o final da coleção é passado, o enumerador é posicionado após o último elemento na coleção e chamar MoveNext retorna false. Se a última chamada para MoveNext retornou false, chamar Current lançará uma exceção. Para definir o atual para o primeiro elemento da coleção novamente, você pode chamar Reset seguido por MoveNext.
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 de forma irrecuperável e a próxima chamada para MoveNext ou Reset lançará uma InvalidOperationException. Se a coleção for modificada entre MoveNext e Current, Current retornará o elemento ao qual ele está definido, mesmo que o enumerador já esteja invalidado.
O enumerador não tem acesso exclusivo à coleção; por isso, a enumeração por meio de uma coleção não é um procedimento thread-safe intrínseco. Mesmo quando uma coleção está sincronizada, outros threads ainda podem modificar a coleção, o que faz o enumerador lançar uma exceção. Para garantir a segurança do thread durante a enumeração, você pode bloquear a coleção durante toda a enumeração ou capturar as exceções que resultam de alterações feitas por outros threads.