GroupCollection.CopyTo Método

Definição

Sobrecargas

CopyTo(Array, Int32)

Copia todos os elementos da coleção para a matriz especificada, começando pelo índice especificado.Copies all the elements of the collection to the given array beginning at the given index.

CopyTo(Group[], Int32)

Copia os elementos da coleção de grupos para uma matriz Group, começando em um índice de matriz específico.Copies the elements of the group collection to a Group array, starting at a particular array index.

CopyTo(Array, Int32)

Copia todos os elementos da coleção para a matriz especificada, começando pelo índice especificado.Copies all the elements of the collection to the given array beginning at the given index.

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

Parâmetros

array
Array

A matriz para a qual a coleção deverá ser copiada.The array the collection is to be copied into.

arrayIndex
Int32

A posição na matriz de destino em que a cópia deverá começar.The position in the destination array where the copying is to begin.

Implementações

Exceções

array é null.array is null.

arrayIndex está fora dos limites de array.arrayIndex is outside the bounds of array.

- ou --or-

arrayIndex mais Count está fora dos limites de array.arrayIndex plus Count is outside the bounds of array.

Exemplos

O exemplo a seguir extrai cada palavra de uma sentença e a captura em um grupo de captura, o método CopyTo é usado para copiar os elementos no objeto GroupCollection de cada correspondência para uma matriz que contém os grupos de captura de todas as correspondências.The following example extracts each word from a sentence and captures it in a capturing group, The CopyTo method is then used to copy the elements in each match's GroupCollection object to an array that contains the capturing groups from all matches. As palavras capturadas individuais são exibidas para o console.The individual captured words are then displayed to the 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:The regular expression is defined as follows:

PadrãoPattern DescriçãoDescription
\b Corresponder a um limite de palavra.Match a word boundary.
(\S+?) Corresponder um ou mais caracteres de espaço não em branco.Match one or more non-white space characters. Atribua-os ao primeiro grupo de captura.Assign them to the first capturing group.
\b Corresponder a um limite de palavra.Match a word boundary.

Comentários

Como toda a coleção é copiada para a matriz, a partir do índice fornecido, a matriz de destino deve ser pelo menos tão grande quanto a coleção.Because the entire collection is copied into the array starting at the given index, the destination array must be at least as large as the collection.

Aviso

Este membro não está presente no Biblioteca de Classes PortátilPortable Class Library.This member is not present in the Biblioteca de Classes PortátilPortable Class Library. Se você estiver desenvolvendo aplicativos direcionados ao Biblioteca de Classes PortátilPortable Class Library, use o método GroupCollection.ICollection.CopyTo em vez disso.If you are developing applications that target the Biblioteca de Classes PortátilPortable Class Library, use the GroupCollection.ICollection.CopyTo method instead.

CopyTo(Group[], Int32)

Copia os elementos da coleção de grupos para uma matriz Group, começando em um índice de matriz específico.Copies the elements of the group collection to a Group array, starting at a particular array index.

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.The one-dimensional array that is the destination of the elements copied from the group collection. A matriz deve ter indexação com base em zero.The array must have zero-based indexing.

arrayIndex
Int32

O índice baseado em zero na array no qual a cópia começa.The zero-based index in array at which copying begins.

Exceções

array é nulo.array is null.

arrayIndex é menor que zero.arrayIndex is less than zero.

- ou --or-

arrayIndex é maior que o comprimento do array.arrayIndex is greater than the length of array.

O comprimento de array - arrayIndex é menor que a contagem da coleção de grupos.The length of array - arrayIndex is less than the group collection count.

Aplica-se a