MatchCollection.GetEnumerator Método
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.
Fornece um enumerador que itera pela coleção.
public:
virtual System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator();abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorDevoluções
Um objeto que contém todos Match os objetos dentro do MatchCollection.
Implementações
Exceções
Houve um castigo.
Observações
Em vez de chamar o GetEnumerator() método para recuperar um enumerador que permite iterar pelos Match objetos da coleção, deve usar o construto de iteração da coleção fornecido pela sua linguagem de programação (como foreach em C#).
Iterar os membros do MatchCollection usando o GetEnumerator() método (ou a foreach instrução) faz com que o motor de expressões regulares preencha a coleção conforme necessário, usando avaliação preguiçosa. Em contraste, o motor de expressões regulares utiliza avaliação direta para preencher a coleção de uma só vez quando a Count propriedade é acedida. Esta pode ser uma forma muito mais dispendiosa de construir a coleção do que uma avaliação preguiçosa.
Como o MatchCollection objeto é geralmente povoado usando avaliação preguiçosa, tentar navegar para o próximo membro da coleção pode lançar uma RegexMatchTimeoutException exceção. Esta exceção pode ser lançada se um valor de time-out para operações de correspondência estiver em vigor, e a tentativa de encontrar a próxima correspondência exceder esse intervalo de time-out.
