GroupCollection.CopyTo Método

Definição

Espaço de Nomes:
System.Text.RegularExpressions
Assemblagens:
netstandard.dll, System.Text.RegularExpressions.dll
Assemblagem:
System.Text.RegularExpressions.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
CopyTo(Array, Int32)

Copia todos os elementos da coleção para o array dado a partir do índice indicado.
CopyTo(Group[], Int32)

Copia os elementos da coleção de grupo para um Group array, começando num índice particular de array.

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 o array dado a partir do índice indicado.

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

O array para onde a coleção deve ser copiada.

arrayIndex
Int32

A posição no array de destino onde 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 seguinte extrai cada palavra de uma frase e captura-a num grupo de captura. O CopyTo método é então usado para copiar os elementos do objeto de GroupCollection cada correspondência para um array que contém os grupos de captura de todas as correspondências. As palavras individuais capturadas são então exibidas na consola.

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 forma:

Pattern Descrição
\b Corresponder a um limite de palavras.
(\S+?) Combine com um ou mais caracteres que não sejam espaços brancos. Atribui-os ao primeiro grupo de captura.
\b Corresponder a um limite de palavras.

Observações

Como toda a coleção é copiada para o array a partir do índice indicado, o array de destino deve ser pelo menos tão grande quanto a coleção.

Warning

Este membro não está presente na Biblioteca de Aulas Portáteis. Se está a desenvolver aplicações direcionadas para a Portable Class Library, 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 grupo para um Group array, começando num índice particular de array.

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[]

O array unidimensional que é o destino dos elementos copiados da coleção do grupo. O array deve ter indexação baseada em zero.

arrayIndex
Int32

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

Implementações

CopyTo(T[], Int32)

Exceções

ArgumentNullException

array é null.

ArgumentOutOfRangeException

arrayIndex é inferior a zero. -ou- arrayIndex é maior do que o comprimento de array.

ArgumentException

O comprimento de array menos arrayIndex é menor do que o número de coletas do grupo.

Aplica-se a