MatchCollection.Item[Int32] Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe um membro individual da coleção.
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
Parâmetros
Valor de Propriedade
A subcorda capturada na posição i da coleção.
Implementações
Exceções
i é menor que 0 ou maior ou igual a Count.
Houve um castigo.
Observações
Em C#, a Item[Int32] propriedade é um indexador; não é explicitamente referenciada no código, mas permite que o MatchCollection acesso seja acedido como se fosse um array.
Normalmente, os itens individuais do MatchCollection índice só são acedidos pelo seu índice depois de o número total de itens na coleção ter sido determinado a partir da Count propriedade. No entanto, aceder à Count propriedade faz com que o motor de expressões regulares utilize uma avaliação direta para construir a coleção de uma só vez. Isto é tipicamente mais dispendioso do que iterar a coleção usando o GetEnumerator() método ou a foreach instrução.
Como o MatchCollection objeto é geralmente povoado através de avaliação preguiçosa, tentar navegar para uma partida específica pode abrir uma RegexMatchTimeoutException exceção. Esta exceção pode ser lançada se estiver em vigor um valor de time-out para operações de correspondência, e a tentativa de encontrar uma correspondência específica exceder esse intervalo de time-out.