GroupCollection.CopyTo Método

Definição

Namespace:
System.Text.RegularExpressions
Assemblies:
netstandard.dll, System.Text.RegularExpressions.dll
Assembly:
System.Text.RegularExpressions.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Sobrecargas

Nome Description
CopyTo(Array, Int32)

Copia todos os elementos da coleção para a matriz determinada começando no índice fornecido.
CopyTo(Group[], Int32)

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

CopyTo(Array, Int32)

Origem:
GroupCollection.cs
Origem:
GroupCollection.cs
Origem:
GroupCollection.cs
Origem:
GroupCollection.cs
Origem:
GroupCollection.cs

Copia todos os elementos da coleção para a matriz determinada começando no índice fornecido.

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 na qual a coleção deve ser copiada.

arrayIndex
Int32

A posição na matriz de destino em que a cópia deve 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:

Pattern Description
\b Corresponder a um limite de palavra.
(\S+?) Corresponde a um ou mais caracteres de espaço não branco. 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.

Warning

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

Aplica-se a

CopyTo(Group[], Int32)

Origem:
GroupCollection.cs
Origem:
GroupCollection.cs
Origem:
GroupCollection.cs
Origem:
GroupCollection.cs
Origem:
GroupCollection.cs

Copia os elementos da coleção de grupos para uma Group matriz, 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 baseada em zero.

arrayIndex
Int32

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

Implementações

CopyTo(T[], Int32)

Exceções

ArgumentNullException

array é null.

ArgumentOutOfRangeException

arrayIndex é menor que zero. -ou- arrayIndex é maior que o comprimento de array.

ArgumentException

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

Aplica-se a