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 пространстве имен не синхронизируются.
