MatchCollection.Item[Int32] Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient un membre individuel de la collection.
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
Paramètres
Valeur de propriété
Sous-chaîne capturée à la position i de la collection.
Implémente
Exceptions
i est inférieur à 0 ou supérieur ou égal à Count.
Un délai d’attente s’est produit.
Remarques
En C#, la Item[Int32] propriété est un indexeur ; elle n’est pas explicitement référencée dans le code, mais permet plutôt l’accès MatchCollection comme s’il s’agissait d’un tableau.
En règle générale, les éléments individuels dans le fichier MatchCollection sont accessibles par leur index uniquement une fois que le nombre total d’éléments de la collection a été déterminé à partir de la Count propriété. Toutefois, l’accès à la Count propriété entraîne l’utilisation directe du moteur d’expression régulière pour générer la collection en même temps. Cela est généralement plus coûteux que d’itérer la collection à l’aide de la GetEnumerator() méthode ou de l’instruction foreach .
Étant donné que l’objet MatchCollection est généralement rempli à l’aide de l’évaluation différée, la tentative d’accès à une correspondance spécifique peut lever une RegexMatchTimeoutException exception. Cette exception peut être levée si une valeur de délai d’attente pour les opérations correspondantes est en vigueur et que la tentative de recherche d’une correspondance spécifique dépasse cet intervalle de délai d’attente.