CaptureCollection.IEnumerable<Capture>.GetEnumerator Метод

Определение

Возвращает перечислитель, выполняющий перебор элементов в коллекции.

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture> IEnumerable<Capture>.GetEnumerator ();

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

Перечислитель, который можно использовать для итерации по коллекции.

Реализации

Комментарии

Возвращаемый IEnumerator<T> объект предоставляет возможность перебора коллекции путем предоставления Current свойства . Перечислители можно использовать для чтения данных в коллекции, но не для изменения коллекции. Изначально перечислитель располагается перед первым элементом коллекции. В этой позиции значение свойства Current не определено. Поэтому необходимо вызвать MoveNext метод , чтобы перейти перечислитель к первому элементу коллекции, прежде чем считывать значение Current. Current возвращает тот же объект до тех пор, пока не MoveNext будет вызван снова в качестве MoveNext набора Current для следующего элемента. Если MoveNext передает конец коллекции, перечислитель располагается после последнего элемента в коллекции и MoveNext возвращает .false Если перечислитель находится в этой позиции, последующие вызовы также MoveNext возвращают false. Если последний вызов MoveNext возвращал false, Current значение не определено. Значение свойства Current не может быть повторно задано первому элементу коллекции; вместо этого следует создать новый экземпляр перечислителя. Если в коллекцию вносятся изменения, такие как добавление, изменение или удаление элементов, поведение перечислителя не определено. Перечислитель не имеет монопольного доступа к коллекции, поэтому перечислитель остается действительным до тех пор, пока коллекция остается неизменной. Если в коллекцию вносятся изменения, такие как добавление, изменение или удаление элементов, перечислитель становится недействительным, и вы можете получить непредвиденные результаты. Кроме того, перечисление коллекции не является потокобезопасной процедурой. Чтобы гарантировать потокобезопасность, необходимо заблокировать коллекцию во время перечислителя или реализовать синхронизацию в коллекции. Реализации коллекций по умолчанию в System.Collections.Generic пространстве имен не синхронизируются.

Применяется к

Өнім Нұсқалар
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1