GroupCollection.CopyTo Método

Definição

Namespace:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Sobrecargas

CopyTo(Array, Int32)	Copia todos os elementos da coleção para a matriz especificada, começando pelo índice especificado.
CopyTo(Group[], Int32)	Copia os elementos da coleção de grupos para uma matriz Group, começando em um índice de matriz específico.

CopyTo(Array, Int32)

Copia todos os elementos da coleção para a matriz especificada, começando pelo índice especificado.

public:
 virtual void CopyTo(Array ^ array, int arrayIndex);

public void CopyTo (Array array, int arrayIndex);

abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit

Public Sub CopyTo (array As Array, arrayIndex As Integer)

Parâmetros

array

Array

A matriz para a qual a coleção deverá ser copiada.

arrayIndex

Int32

A posição na matriz de destino em que a cópia deverá começar.

Implementações

CopyTo(Array, Int32)

Exceções

ArgumentNullException

array é null.

IndexOutOfRangeException

arrayIndex está fora dos limites de array.

- ou -

arrayIndex mais Count está fora dos limites de array.

Exemplos

O exemplo a seguir extrai cada palavra de uma frase e a captura em um grupo de captura, o CopyTo método é usado para copiar os elementos no objeto de GroupCollection cada correspondência para uma matriz que contém os grupos de captura de todas as correspondências. As palavras capturadas individuais são exibidas no console.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\b(\S+?)\b";
      string input = "This sentence is rather short but pointless.";

      MatchCollection matches = Regex.Matches(input, pattern);
      object[] words = new object[matches.Count * 2];
      
      int index = 0;
      foreach (Match match in matches)
      {
         match.Groups.CopyTo(words, index);
         index += 2;
      }
      
      // Display captured groups.
      for (int ctr = 1; ctr <= words.GetUpperBound(0); ctr += 2)
         Console.WriteLine(words[ctr]);
   }
}
// The example displays the following output:
//       This
//       sentence
//       is
//       rather
//       short
//       but
//       pointless

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\b(\S+?)\b"
      Dim input As String = "This sentence is rather short but pointless."

      Dim matches As MatchCollection = Regex.Matches(input, pattern)
      Dim words(matches.Count * 2 - 1) As Object
      
      Dim index As Integer = 0
      For Each match As Match In matches
         match.Groups.CopyTo(words, index)
         index += 2
      Next
      ' Display captured groups.
      For ctr As Integer = 1 To words.GetUpperBound(0) Step 2
         Console.WriteLine(words(ctr))
      Next
   End Sub
End Module
' The example displays the following output:
'       This
'       sentence
'       is
'       rather
'       short
'       but
'       pointless

A expressão regular é definida da seguinte maneira:

Padrão	Descrição
\b	Corresponder a um limite de palavra.
(\S+?)	Corresponda a um ou mais caracteres de espaço não brancos. Atribua-os ao primeiro grupo de captura.
\b	Corresponder a um limite de palavra.

Comentários

Como toda a coleção é copiada para a matriz começando no índice fornecido, a matriz de destino deve ser pelo menos tão grande quanto a coleção.

Aviso

Esse membro não está presente na Biblioteca de Classes Portátil. Se você estiver desenvolvendo aplicativos direcionados à Biblioteca de Classes Portátil, use o GroupCollection.ICollection.CopyTo método em vez disso.

CopyTo(Group[], Int32)

Copia os elementos da coleção de grupos para uma matriz Group, começando em um índice de matriz específico.

public:
 virtual void CopyTo(cli::array <System::Text::RegularExpressions::Group ^> ^ array, int arrayIndex);

public void CopyTo (System.Text.RegularExpressions.Group[] array, int arrayIndex);

abstract member CopyTo : System.Text.RegularExpressions.Group[] * int -> unit
override this.CopyTo : System.Text.RegularExpressions.Group[] * int -> unit

Public Sub CopyTo (array As Group(), arrayIndex As Integer)

Parâmetros

array

Group[]

A matriz unidimensional que é o destino dos elementos copiados da coleção de grupos. A matriz deve ter indexação com base em zero.

arrayIndex

Int32

O índice com base em zero em array no qual a cópia começa.

Implementações

CopyTo(T[], Int32)

Exceções

ArgumentNullException

array é nulo.

ArgumentOutOfRangeException

arrayIndex é menor que zero.

- ou -

arrayIndex é maior que o comprimento do array.

ArgumentException

O comprimento de array - arrayIndex é menor que a contagem da coleção de grupos.