Group.Captures 屬性

定義

命名空間:

System.Text.RegularExpressions

組件:

System.Text.RegularExpressions.dll

組件:

System.dll

組件:

netstandard.dll

依照最內層最左邊為優先的順序，取得符合擷取群組的所有擷取的集合 (如果規則運算式使用 RightToLeft 選項修改，則依照最內層最右邊為優先的順序)， 集合可能有零個或更多項目。

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.CaptureCollection

Public ReadOnly Property Captures As CaptureCollection

屬性值

CaptureCollection

符合群組的子字串集合。

備註

如果數量詞未套用至擷取群組，屬性所傳回的 Captures 集合會包含單 Capture 一物件，提供與 物件相同的子字串 Group 相關資訊。 下列範例會加以說明。 它會定義正則運算式 ， \b(\w+)\b 從句子中擷取單一單字。 物件 Group 會擷取 「This」 一詞，而 中的 CaptureCollection 單一物件包含相同擷取的相關資訊。

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

當數量詞套用至擷取群組時，就會發生屬性的實際公用程式 Captures ，以便群組在單一正則運算式中擷取多個子字串。 在此情況下， Group 物件包含上次擷取之子字串的相關資訊，而 Captures 屬性則包含群組所擷取之所有子字串的相關資訊。 在下列範例中，正則運算式 \b(\w+\s*)+\. 會比對以句點結尾的整個句子。 群組 (\w+\s*)+ 會擷取集合中的個別字組。 Group因為集合只包含最後一個擷取子字串的相關資訊，所以它會擷取句子 「sentence」 中的最後一個字。 不過，群組所擷取的每個字都可以從 屬性所傳回的 Captures 集合取得。

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

另請參閱

• 規則運算式中的群組建構
• 規則運算式中的數量詞