GroupCollection.CopyTo Methode

Definition

Namespace:
System.Text.RegularExpressions
Assemblys:
netstandard.dll, System.Text.RegularExpressions.dll
Assembly:
System.Text.RegularExpressions.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Überlädt

Name Beschreibung
CopyTo(Array, Int32)

Kopiert alle Elemente der Auflistung an das angegebene Array, das am angegebenen Index beginnt.
CopyTo(Group[], Int32)

Kopiert die Elemente der Gruppenauflistung in ein Group Array, beginnend bei einem bestimmten Arrayindex.

CopyTo(Array, Int32)

Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs

Kopiert alle Elemente der Auflistung an das angegebene Array, das am angegebenen Index beginnt.

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)

Parameter

array
Array

Das Array, in das die Auflistung kopiert werden soll.

arrayIndex
Int32

Die Position im Zielarray, an der das Kopieren beginnen soll.

Implementiert

CopyTo(Array, Int32)

Ausnahmen

ArgumentNullException

array ist null.

IndexOutOfRangeException

arrayIndex liegt außerhalb der Grenzen von array. -oder- arrayIndex plus Count liegt außerhalb der Grenzen von array.

Beispiele

Im folgenden Beispiel wird jedes Wort aus einem Satz extrahiert und in einer Aufnahmegruppe erfasst. Die CopyTo Methode wird dann verwendet, um die Elemente im Objekt der einzelnen Übereinstimmungen GroupCollection in ein Array zu kopieren, das die Erfassungsgruppen aus allen Übereinstimmungen enthält. Die einzelnen erfassten Wörter werden dann in der Konsole angezeigt.

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

Der reguläre Ausdruck ist wie folgt definiert:

Pattern Description
\b Eine Wortgrenze identifizieren.
(\S+?) Entspricht einem oder mehreren Nicht-Leerzeichen. Weisen Sie sie der ersten Erfassungsgruppe zu.
\b Eine Wortgrenze identifizieren.

Hinweise

Da die gesamte Auflistung ab dem angegebenen Index in das Array kopiert wird, muss das Zielarray mindestens so groß sein wie die Auflistung.

Warning

Dieses Mitglied ist in der portablen Klassenbibliothek nicht vorhanden. Wenn Sie Anwendungen entwickeln, die auf die portable Klassenbibliothek abzielen, verwenden Sie stattdessen die GroupCollection.ICollection.CopyTo Methode.

Gilt für:

CopyTo(Group[], Int32)

Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs
Quelle:
GroupCollection.cs

Kopiert die Elemente der Gruppenauflistung in ein Group Array, beginnend bei einem bestimmten Arrayindex.

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)

Parameter

array
Group[]

Das eindimensionale Array, das das Ziel der Elemente ist, die aus der Gruppensammlung kopiert wurden. Das Array muss eine nullbasierte Indizierung aufweisen.

arrayIndex
Int32

Der nullbasierte Index, in array dem das Kopieren beginnt.

Implementiert

CopyTo(T[], Int32)

Ausnahmen

ArgumentNullException

array ist null.

ArgumentOutOfRangeException

arrayIndex ist kleiner als 0 (null). -oder- arrayIndex ist größer als die Länge von array.

ArgumentException

Die Länge des array Minuszeichens arrayIndex ist kleiner als die Anzahl der Gruppensammlungen.

Gilt für: