IDTSFriendlyEnumCollection100.GetEnumerator Метод

Определение

Пространство имен:

Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014

Сборка:

Microsoft.SqlServer.DTSPipelineWrap.dll

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.IEnumerator

Public Function GetEnumerator () As IEnumerator

Возвращаемое значение

IEnumerator

IEnumerator, который может проходить через IDTSFriendlyEnumCollection100.

Реализации

GetEnumerator()

Атрибуты

DispIdAttribute

Комментарии

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

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

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

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

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

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