MatchCollection.GetEnumerator Método
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.
Fornece um enumerador que itera por meio da 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 IEnumeratorRetornos
Um objeto que contém todos os Match objetos dentro do MatchCollection.
Implementações
Exceções
Ocorreu um tempo limite.
Comentários
Em vez de chamar o GetEnumerator() método para recuperar um enumerador que permite iterar por meio dos Match objetos na coleção, você deve usar o constructo de iteração de coleção fornecido pela linguagem de programação (como foreach em C#).
Iterar os membros do MatchCollection método GetEnumerator() (ou da foreach instrução) faz com que o mecanismo de expressão regular preencha a coleção conforme necessário usando a avaliação lenta. Por outro lado, o mecanismo de expressão regular usa a avaliação direta para preencher a coleção de uma só vez quando a Count propriedade é acessada. Esse pode ser um método muito mais caro de compilação da coleção do que uma avaliação lenta.
Como o MatchCollection objeto geralmente é preenchido usando uma avaliação lenta, tentar navegar até o próximo membro da coleção 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 a próxima correspondência exceder esse intervalo de tempo limite.
