GroupCollection.CopyTo Metoda

Definicja

Przestrzeń nazw:

System.Text.RegularExpressions

Zestaw:

System.Text.RegularExpressions.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

Przeciążenia

CopyTo(Array, Int32)	Kopiuje wszystkie elementy kolekcji do danej tablicy rozpoczynającej się od danego indeksu.
CopyTo(Group[], Int32)	Kopiuje elementy kolekcji grup do Group tablicy, zaczynając od określonego indeksu tablicy.

CopyTo(Array, Int32)

Kopiuje wszystkie elementy kolekcji do danej tablicy rozpoczynającej się od danego indeksu.

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)

Parametry

array

Array

Tablica, do których ma zostać skopiowana kolekcja.

arrayIndex

Int32

Pozycja w tablicy docelowej, w której należy rozpocząć kopiowanie.

Implementuje

CopyTo(Array, Int32)

Wyjątki

ArgumentNullException

array to null.

IndexOutOfRangeException

arrayIndexznajduje się poza granicami .array

-lub-

arrayIndexplus Count znajduje się poza granicami .array

Przykłady

Poniższy przykład wyodrębnia każde słowo z zdania i przechwytuje je w grupie przechwytywania. CopyTo Metoda jest następnie używana do kopiowania elementów w obiekcie każdego dopasowania GroupCollection do tablicy zawierającej grupy przechwytywania ze wszystkich dopasowań. Poszczególne przechwycone wyrazy są następnie wyświetlane w konsoli programu .

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

Wyrażenie regularne jest definiowane w następujący sposób:

Wzorce	Opis
\b	Dopasowuje granicę wyrazu.
(\S+?)	Dopasuj jeden lub więcej znaków innych niż białe znaki. Przypisz je do pierwszej grupy przechwytywania.
\b	Dopasowuje granicę wyrazu.

Uwagi

Ponieważ cała kolekcja jest kopiowana do tablicy rozpoczynającej się od danego indeksu, tablica docelowa musi być co najmniej tak duża, jak kolekcja.

Ostrzeżenie

Ten element członkowski nie jest obecny w przenośnej bibliotece klas. Jeśli tworzysz aplikacje przeznaczone dla przenośnej biblioteki klas, użyj GroupCollection.ICollection.CopyTo metody .

CopyTo(Group[], Int32)

Kopiuje elementy kolekcji grup do Group tablicy, zaczynając od określonego indeksu tablicy.

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)

Parametry

array

Group[]

Tablica jednowymiarowa, która jest miejscem docelowym elementów skopiowanych z kolekcji grup. Indeksowanie tablicy musi rozpoczynać się od zera.

arrayIndex

Int32

Numerowany od zera indeks w tablicy array, od którego rozpoczyna się kopiowanie.

Implementuje

CopyTo(T[], Int32)

Wyjątki

ArgumentNullException

array ma wartość null.

ArgumentOutOfRangeException

Parametr arrayIndex ma wartość niższą niż zero.

-lub-

arrayIndex jest większa niż długość obiektu array.

ArgumentException

Długość kolekcji array - arrayIndex jest mniejsza niż liczba kolekcji grup.