MatchCollection.Item[Int32] 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 ein einzelnes Element der Auflistung ab.
public:
virtual property System::Text::RegularExpressions::Match ^ default[int] { System::Text::RegularExpressions::Match ^ get(int i); };public virtual System.Text.RegularExpressions.Match this[int i] { get; }member this.Item(int) : System.Text.RegularExpressions.MatchDefault Public Overridable ReadOnly Property Item(i As Integer) As MatchParameter
Eigenschaftswert
Die erfasste Teilzeichenfolge an position i in der Auflistung.
Implementiert
Ausnahmen
i ist kleiner als 0 oder größer als oder gleich Count.
Ein Timeout ist aufgetreten.
Hinweise
In C# ist die Item[Int32] Eigenschaft ein Indexer. Sie wird nicht explizit im Code referenziert, sondern ermöglicht MatchCollection den Zugriff, als wäre es ein Array.
Auf einzelne Elemente im Index wird in der MatchCollection Regel erst zugegriffen, nachdem die Gesamtanzahl der Elemente in der Auflistung anhand der Count Eigenschaft ermittelt wurde. Der Zugriff auf die Count Eigenschaft bewirkt jedoch, dass das Modul für reguläre Ausdrücke die direkte Auswertung verwendet, um die Auflistung auf einmal zu erstellen. Dies ist in der Regel teurer als das Durchlaufen der Auflistung mithilfe der GetEnumerator() Methode oder der foreach Anweisung.
Da das Objekt in der MatchCollection Regel mit einer faulen Auswertung aufgefüllt wird, kann der Versuch, zu einer bestimmten Übereinstimmung zu navigieren, eine RegexMatchTimeoutException Ausnahme auslösen. Diese Ausnahme kann ausgelöst werden, wenn ein Timeoutwert für Abgleichsvorgänge wirksam ist und der Versuch, eine bestimmte Übereinstimmung zu finden, dieses Timeoutintervall überschreitet.
