MatchCollection.Item[Int32] Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает отдельный элемент коллекции.
public:
virtual property System::Text::RegularExpressions::Match ^ default[int] { System::Text::RegularExpressions::Match ^ get(int i); };
public virtual System.Text.RegularExpressions.Match this[int i] { get; }
member this.Item(int) : System.Text.RegularExpressions.Match
Default Public Overridable ReadOnly Property Item(i As Integer) As Match
Параметры
Значение свойства
Захваченная подстрока в позиции i в коллекции.
Реализации
Исключения
i значение меньше 0 или больше или равно Count.
Произошло время ожидания.
Комментарии
В C# Item[Int32] свойство является индексатором; он не ссылается явным образом в коде, но вместо этого позволяет MatchCollection получить доступ к нему, как если бы он был массивом.
Как правило, отдельные элементы в MatchCollection объекте получают доступ к индексу только после определения общего количества элементов в коллекции.Count Однако доступ к свойству Count приводит к тому, что обработчик регулярных выражений будет использовать прямую оценку для сборки коллекции одновременно. Обычно это дороже, чем итерации коллекции с помощью GetEnumerator() метода или инструкции foreach .
MatchCollection Так как объект обычно заполняется с помощью отложенной оценки, попытка перейти к определенному совпадению может вызвать RegexMatchTimeoutException исключение. Это исключение может быть вызвано, если значение времени ожидания для операций сопоставления действует, и попытка найти определенное совпадение превышает этот интервал времени ожидания.