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
- Наследование
Комментарии
Перечислители разрешают только чтение данных в коллекции. Перечислители нельзя использовать для изменения базовой коллекции.
Изначально перечислитель размещается перед первым элементом в коллекции. Метод 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) |