MatchCollection.IEnumerable<Match>.GetEnumerator Método

Definição

Namespace:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Origem:

MatchCollection.cs

Retorna um enumerador que itera pela coleção.

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>

Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumerator

Retornos

IEnumerator<Match>

Um enumerador que pode ser usado para iterar pela coleção.

Implementações

GetEnumerator()

Exceções

NotSupportedException

A coleção é somente leitura.

Comentários

O retornado IEnumerator<T> fornece a capacidade de iterar pela coleção expondo uma Current propriedade . Você pode usar enumeradores para ler os dados em uma coleção, mas não para modificar a coleção. Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. Nesta posição, Current está indefinido. Por isso, você deve chamar o método MoveNext para avançar o enumerador até o primeiro elemento da coleção antes de ler o valor de Current. Current retorna o mesmo objeto até MoveNext ser chamado novamente como MoveNext define Current para o próximo elemento. Caso MoveNext passe o final da coleção, o enumerador é posicionado após o último elemento na coleção e MoveNext retorna false. Quando o enumerador está nessa posição, as chamadas subsequentes para MoveNext também retornam false. Caso a última chamada para MoveNext tenha retornado false, Current está indefinido. Não é possível definir Current como o primeiro elemento da coleção novamente; você deve criar uma nova instância de enumerador em vez disso. Se forem feitas alterações na coleção, como adicionar, modificar ou excluir elementos, o comportamento do enumerador será indefinido. Um enumerador não tem acesso exclusivo à coleção, portanto, um enumerador permanece válido, desde que a coleção permaneça inalterada. Se forem feitas alterações na coleção, como adicionar, modificar ou excluir elementos, o enumerador será invalidado e você poderá obter resultados inesperados. Além disso, enumerar uma coleção não é um procedimento thread-safe. Para garantir a segurança do thread, você deve bloquear a coleção durante o enumerador ou implementar a sincronização na coleção. As implementações padrão de coleções no System.Collections.Generic namespace não são sincronizadas.