GroupCollection.CopyTo Método

Definición

Espacio de nombres:

System.Text.RegularExpressions

Ensamblado:

System.Text.RegularExpressions.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

Sobrecargas

CopyTo(Array, Int32)	Copia todos los elementos de la colección en la matriz indicada a partir del índice especificado.
CopyTo(Group[], Int32)	Copia los elementos de la colección de grupos en una matriz Group, a partir de un índice de matriz concreto.

CopyTo(Array, Int32)

Copia todos los elementos de la colección en la matriz indicada a partir del í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

Matriz en la que se va a copiar la colección.

arrayIndex

Int32

Posición de la matriz de destino donde se inicia la copia.

Implementaciones

CopyTo(Array, Int32)

Excepciones

ArgumentNullException

array es null.

IndexOutOfRangeException

arrayIndex está fuera de los límites de array.

o bien

arrayIndex más Count está fuera de los límites de array.

Ejemplos

En CopyTo el ejemplo siguiente se extrae cada palabra de una oración y se captura en un grupo de captura, el método se usa para copiar los elementos del objeto de GroupCollection cada coincidencia en una matriz que contiene los grupos de captura de todas las coincidencias. A continuación, las palabras capturadas individuales se muestran en la 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

La expresión regular se define de la siguiente manera:

Modelo	Descripción
\b	Coincide con un límite de palabras.
(\S+?)	Coincide con uno o varios caracteres de espacio no en blanco. Asígnelos al primer grupo de captura.
\b	Coincide con un límite de palabras.

Comentarios

Dado que toda la colección se copia en la matriz a partir del índice especificado, la matriz de destino debe ser al menos tan grande como la colección.

Advertencia

Este miembro no está presente en la biblioteca de clases portable. Si va a desarrollar aplicaciones destinadas a la biblioteca de clases portable, use el GroupCollection.ICollection.CopyTo método en su lugar.

CopyTo(Group[], Int32)

Copia los elementos de la colección de grupos en una matriz Group, a partir de un índice de matriz concreto.

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

Matriz unidimensional que constituye el destino de los elementos copiados de la colección de grupos. La matriz debe tener una indización de base cero.

arrayIndex

Int32

Índice de base cero en la array donde comienza la copia.

Implementaciones

CopyTo(T[], Int32)

Excepciones

ArgumentNullException

array es null.

ArgumentOutOfRangeException

arrayIndex es menor que cero.

O bien

arrayIndex es mayor que la longitud de array.

ArgumentException

La longitud de array - arrayIndex es menor que el número de colecciones de grupos.