MatchCollection.Count Eigenschaft

Definition

Namespace:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Quelle:

MatchCollection.cs

Ruft die Anzahl der Übereinstimmungen ab.

public:
 property int Count { int get(); };

public int Count { get; }

member this.Count : int

Public ReadOnly Property Count As Integer

Eigenschaftswert

Int32

Die Anzahl der Übereinstimmungen.

Implementiert

Count Count Count

Ausnahmen

RegexMatchTimeoutException

Es ist ein Timeout aufgetreten.

Beispiele

Im folgenden Beispiel wird mithilfe der Count -Eigenschaft ermittelt, ob der Aufruf der Regex.Matches(String, String) -Methode Übereinstimmungen gefunden hat. Andernfalls gibt dies an, dass keine Übereinstimmungen gefunden wurden. Andernfalls werden die Übereinstimmungen aufgelistet und deren Wert und die Position in der Eingabezeichenfolge angezeigt, an der sie gefunden wurden.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      string[] inputs = { "This sentence contains no numbers.",
                          "123 What do I see?",
                          "2468 369 48 5" };
      foreach (var input in inputs) {
         MatchCollection matches = Regex.Matches(input, pattern);
         Console.WriteLine("Input: {0}", input);
         if (matches.Count == 0)
            Console.WriteLine("   No matches");
         else
            foreach (Match m in matches)
               Console.WriteLine("   {0} at index {1}", m.Value, m.Index);

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       Input: This sentence contains no numbers.
//          No matches
//
//       Input: 123 What do I see?
//          123 at index 0
//
//       Input: 2468 369 48 5
//          2468 at index 0
//          369 at index 5
//          48 at index 9
//          5 at index 12

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim inputs() As String = { "This sentence contains no numbers.",
                                 "123 What do I see?",
                                 "2468 369 48 5" }
      For Each inputStr In inputs
         Dim matches As MatchCollection = Regex.Matches(inputStr, pattern)
         Console.WriteLine("Input: {0}", inputStr)
         If matches.Count = 0
            Console.WriteLine("   No matches")
         Else
            For Each m As Match In matches
               Console.WriteLine("   {0} at index {1}", m.Value, m.Index)
            Next
         End If
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'       Input: This sentence contains no numbers.
'       No matches
'
'       Input: 123 What do I see?
'       123 at index 0
'
'       Input: 2468 369 48 5
'       2468 at index 0
'       369 at index 5
'       48 at index 9
'       5 at index 12

Das Muster \d+ des regulären Ausdrucks entspricht mindestens einem Dezimalzeichen in einer Eingabezeichenfolge.

Hinweise

Durch den Zugriff auf einzelne Member des MatchCollection -Objekts durch Abrufen des Werts Count der -Eigenschaft der Auflistung wird die Engine für reguläre Ausdrücke die Auflistung mithilfe der direkten Auswertung auffüllen. Wenn Sie die -Methode aufrufen (oder die GetEnumeratorforeach -Anweisung in C# und die For Each...Next -Anweisung in Visual Basic verwenden), wird die Sammlung durch die Engine für reguläre Ausdrücke nach Bedarf mithilfe der verzögerten Auswertung aufgefüllt. Die direkte Auswertung kann eine viel teurere Methode zum Erstellen der Sammlung sein als eine verzögerte Auswertung.

Da das Objekt in der MatchCollection Regel mithilfe der verzögerten Auswertung aufgefüllt wird, kann der Versuch, die Anzahl der Elemente in der Auflistung zu bestimmen, bevor es vollständig aufgefüllt wurde, eine RegexMatchTimeoutException Ausnahme auslösen. Diese Ausnahme kann ausgelöst werden, wenn ein Timeoutwert für Abgleichsvorgänge wirksam ist und der Versuch, eine einzelne Übereinstimmung zu finden, dieses Timeoutintervall überschreitet.