GroupCollection.CopyTo Méthode

Définition

Espace de noms:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Surcharges

CopyTo(Array, Int32)	Copie tous les éléments de la collection dans le tableau donné en commençant à l'index spécifié.
CopyTo(Group[], Int32)	Copie les éléments de la collection de groupes dans un tableau Group, en commençant au niveau d’un index de tableau particulier.

CopyTo(Array, Int32)

Copie tous les éléments de la collection dans le tableau donné en commençant à l'index spécifié.

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)

Paramètres

array

Array

Tableau dans lequel la collection doit être copiée.

arrayIndex

Int32

Position à laquelle la copie doit commencer dans le tableau de destination.

Implémente

CopyTo(Array, Int32)

Exceptions

ArgumentNullException

array a la valeur null.

IndexOutOfRangeException

arrayIndex est en dehors des limites de array.

• ou -

arrayIndex plus Count sont en dehors des limites de array.

Exemples

L’exemple suivant extrait chaque mot d’une phrase et le capture dans un groupe de captures, la CopyTo méthode est ensuite utilisée pour copier les éléments de l’objet de GroupCollection chaque correspondance dans un tableau qui contient les groupes de capture de toutes les correspondances. Les mots capturés individuels sont ensuite affichés dans la 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’expression régulière est définie comme suit :

Motif	Description
\b	Mettre en correspondance la limite d'un mot.
(\S+?)	Correspond à un ou plusieurs caractères d’espace non blanc. Attribuez-les au premier groupe de capture.
\b	Mettre en correspondance la limite d'un mot.

Remarques

Étant donné que la collection entière est copiée dans le tableau à partir de l’index donné, le tableau de destination doit être au moins aussi grand que la collection.

Avertissement

Ce membre n’est pas présent dans la bibliothèque de classes portable. Si vous développez des applications qui ciblent la bibliothèque de classes portables, utilisez plutôt la GroupCollection.ICollection.CopyTo méthode.

CopyTo(Group[], Int32)

Copie les éléments de la collection de groupes dans un tableau Group, en commençant au niveau d’un index de tableau particulier.

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)

Paramètres

array

Group[]

Tableau unidimensionnel qui constitue la destination des éléments copiés à partir de la collection de groupes. Ce tableau doit avoir une indexation de base zéro.

arrayIndex

Int32

Index de base zéro dans l'array à partir duquel la copie commence.

Implémente

CopyTo(T[], Int32)

Exceptions

ArgumentNullException

array a la valeur null.

ArgumentOutOfRangeException

arrayIndex est inférieur à zéro.

• ou -

arrayIndex est supérieur à la longueur de array.

ArgumentException

La longueur de array - arrayIndex est inférieure au nombre de collections de groupes.