BreakpointTargetEnumerator Classe
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.
Cria um BreakpointTargetEnumerator para a coleção BreakpointTargets. Essa classe não pode ser herdada.
public ref class BreakpointTargetEnumerator sealed : Microsoft::SqlServer::Dts::Runtime::DtsEnumeratorpublic sealed class BreakpointTargetEnumerator : Microsoft.SqlServer.Dts.Runtime.DtsEnumeratortype BreakpointTargetEnumerator = class
inherit DtsEnumeratorPublic NotInheritable Class BreakpointTargetEnumerator
Inherits DtsEnumerator- Herança
Comentários
Os enumeradores habilitam apenas 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. O método Reset também retorna o enumerador a essa posição. Nessa posição, chamar a Current propriedade gera uma exceção. Portanto, você deve chamar MoveNext o método 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. MoveNext define Current 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 a chamada MoveNext retorna false. Se a última chamada a ser MoveNext retornada false, a chamada Current gerará uma exceção. Para definir Current como o primeiro elemento da coleção novamente, é possível chamar Reset seguido de 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 e se tornará irrecuperável; portanto, a próxima chamada para MoveNext ou Reset gera um InvalidOperationException. No entanto, se a coleção for modificada entre MoveNext e Current, Current retornará o elemento ao qual está definida, mesmo que o enumerador tenha sido invalidado.
O enumerador não tem acesso exclusivo à coleção; portanto, enumerar por meio de uma coleção não é um procedimento thread-safe. Mesmo quando uma coleção é sincronizada, outros threads ainda podem modificar a coleção, o que faz com que o enumerador gere uma exceção. Para garantir thread-safe durante a enumeração, é possível bloquear a coleção durante toda a enumeração ou verificar as exceções resultantes das alterações feitas por outros threads.
Propriedades
| Current |
Obtém o objeto BreakpointTarget atual na coleção. |
Métodos
| MoveNext() |
Avança o enumerador para o próximo elemento da coleção. (Herdado de DtsEnumerator) |
| Reset() |
Define o enumerador com sua posição inicial, que é antes do primeiro elemento da coleção. (Herdado de DtsEnumerator) |