BreakpointTargetEnumerator Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea BreakpointTargetEnumerator para la colección BreakpointTargets. Esta clase no puede heredarse.
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- Herencia
Comentarios
Los enumeradores sólo habilitan la lectura de los datos de la colección. Los enumeradores no se pueden usar para modificar la colección subyacente.
En principio, el enumerador se coloca antes del primer elemento de la colección. El Reset método también devuelve el enumerador a esta posición. En esta posición, al llamar a la Current propiedad se produce una excepción. Por lo tanto, debe llamar MoveNext al método para avanzar el enumerador al primer elemento de la colección antes de leer el valor de Current.
Current devuelve el mismo objeto hasta que se llama a MoveNext o a Reset. MoveNext establece Current en el siguiente elemento.
Cuando se pasa el final de la colección, el enumerador se coloca detrás del último elemento de la colección y si se llama al método MoveNext devuelve false. Si se devuelve falsela última llamada a MoveNext , al llamar Current se produce una excepción. Para volver a establecer el valor de Current en el primer elemento de la colección, se puede llamar primero a Reset y después a MoveNext.
Un enumerador sigue siendo válido mientras la colección permanezca inalterada. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el enumerador se invalida y se convierte en irrecuperable; por lo tanto, la siguiente llamada a MoveNext o Reset produce una InvalidOperationExceptionexcepción . Sin embargo, si la colección se modifica entre MoveNext y Current, Current devolverá el elemento en el que está establecido, incluso si el enumerador se ha invalidado.
El enumerador no tiene acceso exclusivo a la colección; por lo tanto, la enumeración a través de una colección no es un procedimiento seguro para subprocesos. Incluso cuando se sincroniza una colección, otros subprocesos podrían seguir modificando la colección, lo que hace que el enumerador produzca una excepción. Con el fin de garantizar la seguridad para la ejecución de subprocesos durante la enumeración, se puede bloquear la colección durante toda la enumeración o detectar las excepciones resultantes de los cambios realizados por otros subprocesos.
Propiedades
| Current |
Obtiene el objeto actual BreakpointTarget desde la colección. |
Métodos
| MoveNext() |
Desplaza el enumerador al siguiente elemento de la colección. (Heredado de DtsEnumerator) |
| Reset() |
Establece el enumerador en su posición inicial (antes del primer elemento de la colección). (Heredado de DtsEnumerator) |