Udostępnij za pośrednictwem


GroupCollection.CopyTo Metoda

Definicja

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

Wyjątki

array to null.

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 .

Dotyczy

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

Wyjątki

array ma wartość null.

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

-lub-

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

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

Dotyczy