Group.Captures Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Auflistung aller der Erfassungsgruppe entsprechenden Erfassungsübereinstimmungen in der Reihenfolge von innen nach außen und von links nach rechts ab (oder in der Reihenfolge von innen nach außen und von rechts nach links bei einer Änderung des regulären Ausdrucks mit der RightToLeft-Option). Die Auflistung kann 0 (null) oder mehr Elemente enthalten.
public:
property System::Text::RegularExpressions::CaptureCollection ^ Captures { System::Text::RegularExpressions::CaptureCollection ^ get(); };public System.Text.RegularExpressions.CaptureCollection Captures { get; }member this.Captures : System.Text.RegularExpressions.CaptureCollectionPublic ReadOnly Property Captures As CaptureCollectionEigenschaftswert
Die Auflistung der Teilzeichenfolge, die mit der Gruppe übereinstimmen.
Hinweise
Wenn ein Quantifizierer nicht auf eine Aufnahmegruppe angewendet wird, enthält die von der Captures Eigenschaft zurückgegebene Auflistung ein einzelnes Capture Objekt, das Informationen über die gleiche Teilzeichenfolge wie das Group Objekt bereitstellt. Dies wird im folgenden Beispiel illustriert. Es definiert einen regulären Ausdruck, \b(\w+)\bder ein einzelnes Wort aus einem Satz extrahiert. Das Group Objekt erfasst das Wort "This", und das einzelne Objekt in der CaptureCollection Datei enthält Informationen zu derselben Aufnahme.
using System;
using System.Text.RegularExpressions;
public class Example
{
public static void Main()
{
string pattern = @"\b(\w+)\b";
string input = "This is one sentence.";
Match match = Regex.Match(input, pattern);
if (match.Success) {
Console.WriteLine("Matched text: {0}", match.Value);
for (int ctr = 1; ctr <= match.Groups.Count - 1; ctr++) {
Console.WriteLine(" Group {0}: {1}", ctr, match.Groups[ctr].Value);
int captureCtr = 0;
foreach (Capture capture in match.Groups[ctr].Captures) {
Console.WriteLine(" Capture {0}: {1}",
captureCtr, capture.Value);
captureCtr += 1;
}
}
}
}
}
// The example displays the following output:
// Matched text: This
// Group 1: This
// Capture 0: This
Imports System.Text.RegularExpressions
Module Example
Public Sub Main()
Dim pattern As String = "\b(\w+)\b"
Dim input As String = "This is one sentence."
Dim match As Match = Regex.Match(input, pattern)
If match.Success Then
Console.WriteLine("Matched text: {0}", match.Value)
For ctr As Integer = 1 To match.Groups.Count - 1
Console.WriteLine(" Group {0}: {1}", ctr, match.Groups(ctr).Value)
Dim captureCtr As Integer = 0
For Each capture As Capture In match.Groups(ctr).Captures
Console.WriteLine(" Capture {0}: {1}", _
captureCtr, capture.Value)
captureCtr += 1
Next
Next
End If
End Sub
End Module
' The example displays the following output:
' Matched text: This
' Group 1: This
' Capture 0: This
Das tatsächliche Dienstprogramm der Captures Eigenschaft tritt auf, wenn ein Quantifizierer auf eine Aufnahmegruppe angewendet wird, sodass die Gruppe mehrere Teilzeichenfolgen in einem einzelnen regulären Ausdruck erfasst. In diesem Fall enthält das Objekt Informationen zu der letzten erfassten Unterzeichenfolge, während die Group Captures Eigenschaft Informationen zu allen von der Gruppe erfassten Teilzeichenfolgen enthält. Im folgenden Beispiel entspricht der reguläre Ausdruck \b(\w+\s*)+\. einem gesamten Satz, der in einem Zeitraum endet. Die Gruppe (\w+\s*)+ erfasst die einzelnen Wörter in der Auflistung. Da die Group Auflistung Nur Informationen über die letzte erfasste Teilzeichenfolge enthält, erfasst sie das letzte Wort im Satz "Satz". Jedes von der Gruppe erfasste Wort ist jedoch aus der von der Captures Eigenschaft zurückgegebenen Auflistung verfügbar.
using System;
using System.Text.RegularExpressions;
public class Example
{
public static void Main()
{
string input = "This is a sentence. This is another sentence.";
string pattern = @"\b(\w+\s*)+\.";
Match match = Regex.Match(input, pattern);
if (match.Success) {
Console.WriteLine("Matched text: {0}", match.Value);
for (int ctr = 1; ctr < match.Groups.Count; ctr++) {
Console.WriteLine(" Group {0}: {1}", ctr, match.Groups[ctr].Value);
int captureCtr = 0;
foreach (Capture capture in match.Groups[ctr].Captures) {
Console.WriteLine(" Capture {0}: {1}",
captureCtr, capture.Value);
captureCtr++;
}
}
}
}
}
// The example displays the following output:
// Matched text: This is a sentence.
// Group 1: sentence
// Capture 0: This
// Capture 1: is
// Capture 2: a
// Capture 3: sentence
Imports System.Text.RegularExpressions
Module Example
Public Sub Main()
Dim input As String = "This is a sentence. This is another sentence."
Dim pattern As String = "\b(\w+\s*)+\."
Dim match As Match = Regex.Match(input, pattern)
If match.Success Then
Console.WriteLine("Matched text: {0}", match.Value)
For ctr As Integer = 1 To match.Groups.Count - 1
Console.WriteLine(" Group {0}: {1}", ctr, match.Groups(ctr).Value)
Dim captureCtr As Integer = 0
For Each capture As Capture In match.Groups(ctr).Captures
Console.WriteLine(" Capture {0}: {1}", _
captureCtr, capture.Value)
captureCtr += 1
Next
Next
End If
End Sub
End Module
' The example displays the following output:
' Matched text: This is a sentence.
' Group 1: sentence
' Capture 0: This
' Capture 1: is
' Capture 2: a
' Capture 3: sentence