MatchCollection.IEnumerable<Match>.GetEnumerator Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает перечислитель, который выполняет итерацию по коллекции.
virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator();abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumeratorВозвращаемое значение
Перечислитель, который можно использовать для итерации по коллекции.
Реализации
Исключения
Коллекция доступна только для чтения.
Комментарии
Возвращаемый IEnumerator<T> предоставляет возможность итерации через коллекцию путем предоставления Current свойства. Перечислители можно использовать для чтения данных в коллекции, но не для изменения коллекции.
Изначально перечислитель размещается перед первым элементом в коллекции. На этой позиции Current не определен. Поэтому необходимо вызвать MoveNext метод, чтобы перенаставить перечислителя в первый элемент коллекции, прежде чем считывать значение Current.
Current возвращает тот же объект, пока MoveNext не вызовется снова, как MoveNext задано Current для следующего элемента.
Если MoveNext передает конец коллекции, перечислитель размещается после последнего элемента в коллекции и MoveNext возвращается false. Если перечислитель находится в этой позиции, последующие вызовы MoveNext также возвращаются false. Если последний вызов MoveNext возвращен false, Current не определен. Нельзя снова задать Current первый элемент коллекции. Вместо этого необходимо создать новый экземпляр перечислителя. Если изменения вносятся в коллекцию, например добавление, изменение или удаление элементов, поведение перечислителя не определено.
Перечислитель не имеет монопольного доступа к коллекции, поэтому перечислитель остается допустимым, пока коллекция остается неизменной. Если изменения внесены в коллекцию, например добавление, изменение или удаление элементов, перечислитель недействителен и может получить непредвиденные результаты. Кроме того, перечисление коллекции не является потокобезопасной процедурой. Чтобы гарантировать безопасность потоков, необходимо заблокировать коллекцию во время перечисления или реализовать синхронизацию в коллекции.
Реализации коллекций по умолчанию в System.Collections.Generic пространстве имен не синхронизируются.
