MatchCollection.Item[Int32] Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém 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.MatchDefault Public Overridable ReadOnly Property Item(i As Integer) As MatchParâmetros
Valor da propriedade
A subcadeia de caracteres capturada na posição i da coleção.
Implementações
Exceções
i é menor que 0 ou maior que ou igual a Count.
Ocorreu um tempo limite.
Comentários
Em C#, a Item[Int32] propriedade é um indexador; ela não é explicitamente referenciada no código, mas permite que ela MatchCollection seja acessada como se fosse uma matriz.
Normalmente, os MatchCollection itens individuais no índice são acessados apenas após o número total de itens na coleção ter sido determinado da Count propriedade. No entanto, acessar a Count propriedade faz com que o mecanismo de expressão regular use a avaliação direta para compilar a coleção de uma só vez. Normalmente, isso é mais caro do que iterar a coleção usando o GetEnumerator() método ou a instrução foreach .
Como o MatchCollection objeto geralmente é preenchido usando uma avaliação lenta, tentar navegar para uma correspondência específica pode gerar uma RegexMatchTimeoutException exceção. Essa exceção poderá ser gerada se um valor de tempo limite para operações correspondentes estiver em vigor e a tentativa de localizar uma correspondência específica exceder esse intervalo de tempo limite.
