GroupCollection.CopyTo Yöntem

Tanım

Ad Alanı:

System.Text.RegularExpressions

Bütünleştirilmiş Kod:

System.Text.RegularExpressions.dll

Bütünleştirilmiş Kod:

System.dll

Bütünleştirilmiş Kod:

netstandard.dll

Aşırı Yüklemeler

CopyTo(Array, Int32)	Koleksiyonun tüm öğelerini verilen dizinden başlayarak verilen diziye kopyalar.
CopyTo(Group[], Int32)	Grup koleksiyonunun öğelerini belirli bir Group dizi dizininden başlayarak bir diziye kopyalar.

CopyTo(Array, Int32)

Koleksiyonun tüm öğelerini verilen dizinden başlayarak verilen diziye kopyalar.

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)

Parametreler

array

Array

Koleksiyonun kopyalanacak dizisi.

arrayIndex

Int32

Hedef dizide kopyalamanın başlayacağı konum.

Uygulamalar

CopyTo(Array, Int32)

Özel durumlar

ArgumentNullException

array, null değeridir.

IndexOutOfRangeException

arrayIndex , sınırlarının arraydışındadır.

-veya-

arrayIndex artı Count , sınırlarının arraydışındadır.

Örnekler

Aşağıdaki örnek tümcedeki her sözcüğü ayıklar ve bir yakalama grubunda yakalar. Yöntemi CopyTo daha sonra her eşleşmenin nesnesindeki öğeleri tüm eşleşmelerden GroupCollection yakalama gruplarını içeren bir diziye kopyalamak için kullanılır. Yakalanan tek tek sözcükler daha sonra konsolda görüntülenir.

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

Normal ifade aşağıdaki gibi tanımlanır:

Desen	Description
\b	Bir sözcük sınırıyla eşleş.
(\S+?)	Bir veya daha fazla boşluk olmayan karakteri eşleştirin. Bunları ilk yakalama grubuna atayın.
\b	Bir sözcük sınırıyla eşleş.

Açıklamalar

Koleksiyonun tamamı verilen dizinden başlayarak diziye kopyalandığından, hedef dizi en az koleksiyon kadar büyük olmalıdır.

Uyarı

Bu üye Taşınabilir Sınıf Kitaplığı'nda yok. Taşınabilir Sınıf Kitaplığı'nı hedefleyen uygulamalar geliştiriyorsanız, bunun yerine yöntemini kullanın GroupCollection.ICollection.CopyTo .

CopyTo(Group[], Int32)

Grup koleksiyonunun öğelerini belirli bir Group dizi dizininden başlayarak bir diziye kopyalar.

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)

Parametreler

array

Group[]

Grup koleksiyonundan kopyalanan öğelerin hedefi olan tek boyutlu dizi. Dizinin sıfır tabanlı dizinlemeye sahip olması gerekir.

arrayIndex

Int32

array içinde kopyalamanın başladığı sıfır tabanlı dizin.

Uygulamalar

CopyTo(T[], Int32)

Özel durumlar

ArgumentNullException

array null değeridir.

ArgumentOutOfRangeException

arrayIndex, sıfırdan küçüktür.

-veya-

arrayIndex uzunluğundan arraybüyük.

ArgumentException

uzunluğu array - arrayIndex , grup koleksiyonu değerinden daha azdır.