Язык

BreakpointTargetEnumerator Класс

Определение

Создаёт BreakpointTargetEnumerator для BreakpointTargets коллекции. Этот класс не наследуется.

public ref class BreakpointTargetEnumerator sealed : Microsoft::SqlServer::Dts::Runtime::DtsEnumerator
public sealed class BreakpointTargetEnumerator : Microsoft.SqlServer.Dts.Runtime.DtsEnumerator
type BreakpointTargetEnumerator = class
    inherit DtsEnumerator
Public NotInheritable Class BreakpointTargetEnumerator
Inherits DtsEnumerator
Наследование
BreakpointTargetEnumerator

Комментарии

Перечислители разрешают только чтение данных в коллекции. Перечислители нельзя использовать для изменения базовой коллекции.

Изначально перечислитель размещается перед первым элементом в коллекции. Метод Reset также возвращает перечислитель к этой позиции. При вызове Current свойства вызывается исключение. Поэтому необходимо вызвать MoveNext метод, чтобы перевести переписчик к первому элементу коллекции перед чтением значения Current.

Current возвращает один и тот же объект, пока MoveNextReset не вызывается либо вызывается. MoveNext задает Current для следующего элемента.

После прохождения конца коллекции перечислитель размещается после последнего элемента в коллекции и возвращает вызов MoveNextfalse. Если последний вызов MoveNext возвращен false, вызов Current вызывает исключение. Чтобы снова задать Current для первого элемента коллекции, можно вызвать Reset после этого MoveNext.

Перечислитель остается допустимым, пока коллекция остается неизменной. Если в коллекцию вносятся изменения, такие как добавление, изменение или удаление элементов, переписчик считается недействительным и становится невосстановимым; таким образом, следующий вызов в MoveNext или Reset бросает .InvalidOperationException Однако, если коллекция изменена между MoveNext и Current, Current то вернёт элемент, на который она настроена, даже если переписчик был невалидирован.

Переписчик не имеет эксклюзивного доступа к коллекции; поэтому перечисление через коллекцию не является безопасной для потоковой процедуры. Даже если коллекция синхронизирована, другие потоки по-прежнему могут изменить коллекцию, что приводит к возникновению исключения перечислителем. Чтобы гарантировать безопасность потоков во время перечисления, можно заблокировать коллекцию во время всего перечисления или поймать исключения, полученные из изменений, внесенных другими потоками.

Свойства

Имя Описание
Current

Получает текущий BreakpointTarget объект из коллекции.

Методы

Имя Описание
MoveNext()

Перемещает перечислитель к следующему элементу коллекции.

(Унаследовано от DtsEnumerator)
Reset()

Задает перечислителю начальную позицию, которая перед первым элементом в коллекции.

(Унаследовано от DtsEnumerator)

Применяется к