SortedList<TKey,TValue>.GetEnumerator Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает перечислитель, который выполняет итерацию через SortedList<TKey,TValue>.
public:
System::Collections::Generic::IEnumerator<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ GetEnumerator();public System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<TKey,TValue>> GetEnumerator();member this.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<'Key, 'Value>>Public Function GetEnumerator () As IEnumerator(Of KeyValuePair(Of TKey, TValue))Возвращаемое значение
IEnumerator<T> Тип KeyValuePair<TKey,TValue> для SortedList<TKey,TValue>объекта .
Реализации
Комментарии
Оператор foreach языка C# (For Each в Visual Basic) скрывает сложность перечислителей. Поэтому рекомендуется использовать foreach вместо непосредственного управления перечислителем.
Перечислители можно использовать для чтения данных в коллекции, но их нельзя использовать для изменения базовой коллекции.
Словарь сохраняется в отсортированного порядке с помощью внутреннего дерева. Каждый новый элемент размещается в правильной позиции сортировки, и дерево настраивается для поддержания порядка сортировки при удалении элемента. При перечислении порядок сортировки сохраняется.
Изначально перечислитель размещается перед первым элементом в коллекции. На этой позиции Current не определен. Поэтому перед чтением значения MoveNextнеобходимо вызвать Current перечислитель к первому элементу коллекции.
Current возвращает тот же объект до MoveNext вызова. MoveNext задает Current для следующего элемента.
Если MoveNext передает конец коллекции, перечислитель размещается после последнего элемента в коллекции и MoveNext возвращается false. Если перечислитель находится в этой позиции, последующие вызовы для MoveNext возврата false. Если последний вызов MoveNext возвращен false, Current не определен. Нельзя снова задать Current первый элемент коллекции. Вместо этого необходимо создать новый экземпляр перечислителя.
Перечислитель остается допустимым, пока коллекция остается неизменной. Если изменения вносятся в коллекцию, например добавление, изменение или удаление элементов, перечислитель неустранимо недопустим, а следующий вызов MoveNext или вызов вызывает ResetисключениеInvalidOperationException.
Перечислитель не имеет монопольного доступа к коллекции; Таким образом, перечисление через коллекцию по сути не является потокобезопасной процедурой. Чтобы гарантировать безопасность потоков во время перечисления, можно заблокировать коллекцию во время всего перечисления. Чтобы разрешить доступ к коллекции несколькими потоками для чтения и записи, необходимо реализовать собственную синхронизацию.
Реализации коллекций по умолчанию не System.Collections.Generic синхронизируются.
Этот метод является операцией O(1).
