GroupCollection.CopyTo Metodo

Definizione

Spazio dei nomi:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Overload

CopyTo(Array, Int32)	Copia tutti gli elementi della raccolta nella matrice indicata a partire dall'indice specificato.
CopyTo(Group[], Int32)	Copia gli elementi della raccolta di gruppi in una matrice Group, a partire da un indice della matrice specifico.

CopyTo(Array, Int32)

Copia tutti gli elementi della raccolta nella matrice indicata a partire dall'indice specificato.

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)

Parametri

array

Array

Matrice in cui copiare la raccolta.

arrayIndex

Int32

Posizione nella matrice di destinazione in cui iniziare la copia.

Implementazioni

CopyTo(Array, Int32)

Eccezioni

ArgumentNullException

array è null.

IndexOutOfRangeException

arrayIndex non rientra nei limiti di array.

-oppure-

arrayIndex e Count non rientrano nei limiti di array.

Esempio

L'esempio seguente estrae ogni parola da una frase e la acquisisce in un gruppo di acquisizione. Il CopyTo metodo viene quindi usato per copiare gli elementi nell'oggetto di GroupCollection ogni corrispondenza in una matrice contenente i gruppi di acquisizione da tutte le corrispondenze. Le singole parole acquisite vengono quindi visualizzate nella 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

L'espressione regolare è definita come segue:

Modello	Descrizione
\b	Trova la corrispondenza di un confine di parola.
(\S+?)	Trova la corrispondenza con uno o più caratteri non vuoti. Assegnarli al primo gruppo di acquisizione.
\b	Trova la corrispondenza di un confine di parola.

Commenti

Poiché l'intera raccolta viene copiata nella matrice a partire dall'indice specificato, la matrice di destinazione deve essere almeno grande quanto la raccolta.

Avviso

Questo membro non è presente nella libreria di classi portabile. Se si sviluppano applicazioni destinate alla libreria di classi portabile, usare invece il GroupCollection.ICollection.CopyTo metodo .

CopyTo(Group[], Int32)

Copia gli elementi della raccolta di gruppi in una matrice Group, a partire da un indice della matrice specifico.

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)

Parametri

array

Group[]

Matrice unidimensionale che rappresenta la destinazione degli elementi copiati dalla raccolta di gruppi. La matrice deve avere un'indicizzazione in base zero.

arrayIndex

Int32

Indice in base zero in array in corrispondenza del quale viene avviata la copia.

Implementazioni

CopyTo(T[], Int32)

Eccezioni

ArgumentNullException

array è null.

ArgumentOutOfRangeException

arrayIndex è minore di zero.

-oppure-

arrayIndex è maggiore della lunghezza di array.

ArgumentException

La lunghezza di array - arrayIndex è inferiore al numero di raccolte di gruppi.