MatchCollection.Item[Int32] Proprietà

Definizione

Ottiene un singolo membro della raccolta.

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.Match
Default Public Overridable ReadOnly Property Item(i As Integer) As Match

Parametri

i
Int32

Indice nella Match raccolta.

Valore della proprietà

Sottostringa acquisita in corrispondenza della posizione i nella raccolta.

Implementazioni

Eccezioni

i è minore di 0 o maggiore o uguale a Count.

Si è verificato un timeout.

Commenti

In C#, la Item[Int32] proprietà è un indicizzatore, non fa riferimento in modo esplicito nel codice, ma consente l'accesso all'oggetto MatchCollection come se fosse una matrice.

In genere, i singoli elementi nell'oggetto MatchCollection sono accessibili dal relativo indice solo dopo che il numero totale di elementi nell'insieme è stato determinato dalla Count proprietà . Tuttavia, l'accesso alla Count proprietà fa sì che il motore delle espressioni regolari usi la valutazione diretta per compilare la raccolta contemporaneamente. Questo è in genere più costoso rispetto all'iterazione della raccolta usando il GetEnumerator() metodo o l'istruzione foreach .

Poiché l'oggetto MatchCollection viene in genere popolato usando la valutazione differita, il tentativo di passare a una corrispondenza specifica può generare un'eccezione RegexMatchTimeoutException . Questa eccezione può essere generata se è attivo un valore di timeout per le operazioni di corrispondenza e il tentativo di trovare una corrispondenza specifica supera tale intervallo di timeout.

Si applica a

Vedi anche