Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

MatchCollection (Clase)

Representa el conjunto de coincidencias con éxito encontradas por la solicitud iterada de un modelo de expresión regular en la cadena de entrada.

System.Object
  System.Text.RegularExpressions.MatchCollection

Espacio de nombres:  System.Text.RegularExpressions
Ensamblado:  System (en System.dll)

[SerializableAttribute]
public class MatchCollection : ICollection, 
	IEnumerable

El tipo MatchCollection expone los siguientes miembros.

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCountObtiene el número de coincidencias.
Propiedad públicaCompatible con XNA FrameworkIsReadOnlyObtiene un valor que indica si la colección es de solo lectura.
Propiedad públicaCompatible con XNA FrameworkIsSynchronizedObtiene un valor que indica si el acceso a la colección está sincronizado (es seguro para la ejecución de subprocesos).
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsItemObtiene un miembro individual de la colección.
Propiedad públicaCompatible con XNA FrameworkSyncRootObtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCopyToCopia todos los elementos de la colección en la matriz indicada a partir del índice dado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetEnumeratorOfrece un enumerador que recorre en iteración la colección.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Método de extensión públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAsParallelHabilita la paralelización de una consulta. (Definido por ParallelEnumerable).
Método de extensión públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAsQueryableConvierte una interfaz IEnumerable en IQueryable. (Definido por Queryable).
Método de extensión públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCast<TResult>Convierte los elementos de IEnumerable en el tipo especificado. (Definido por Enumerable).
Método de extensión públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsOfType<TResult>Filtra los elementos de IEnumerable en función de un tipo especificado. (Definido por Enumerable).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsICollection.CopyToCopia todos los elementos de la colección en la matriz especificada, empezando por el índice especificado.
Implementación explícita de interfacesPropiedad privadaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsICollection.IsSynchronizedObtiene un valor que indica si el acceso a la colección está sincronizado (es seguro para la ejecución de subprocesos).
Implementación explícita de interfacesPropiedad privadaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsICollection.SyncRootObtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.
Arriba

La colección es inmutable (de solo lectura) y no tiene constructor público. El método Regex.Matches devuelve un objeto MatchCollection.

La colección contiene cero o varios objetos System.Text.RegularExpressions.Match. Si la coincidencia es correcta, la colección se rellena con un objeto System.Text.RegularExpressions.Match para cada coincidencia situada en la cadena de entrada. Si la coincidencia es correcta, la colección no contiene objetos System.Text.RegularExpressions.Match y su propiedadCount es igual a cero.

Al aplicar un modelo de expresión regular a una cadena de entrada determinada, el motor de expresiones regulares utiliza cualquiera de las dos técnicas para crear el objeto MatchCollection:

  • Evaluación directa.

    El objeto MatchCollection se rellena de una sola vez con todas las coincidencias resultantes de una llamada concreta al método Regex.Matches. Esta técnica se utiliza cuando se obtiene acceso a la propiedad Count de la colección. Suele ser el método más caro para rellenar la colección e implica una mayor disminución del rendimiento.

  • Evaluación lenta.

    El objeto MatchCollection se rellena según sea necesario coincidencia por coincidencia. Equivale a repetidas llamadas por parte del motor de expresiones regulares al método Regex.Match y la adición de cada coincidencia a la colección. Esta técnica se utiliza cuando se obtiene acceso a la colección a través de su método GetEnumerator, o bien, cuando se obtiene acceso mediante la instrucción foreach (en C#) o la instrucción For Each ...Next (en Visual Basic).

Para recorrer en iteración los miembros de una colección, debería utiliza la construcción de la iteración de colección que proporciona el lenguaje de programación (como foreach en C# y For EachNext en Visual Basic) en vez de recuperar el enumerador que devuelve el método GetEnumerator.

En el ejemplo siguiente se muestra el uso de la clase MatchCollection para interrogar un conjunto de instancias Match.


using System;
using System.Text.RegularExpressions;

public class Test
{

    public static void Main ()
    {

        // Define a regular expression for repeated words.
        Regex rx = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b",
          RegexOptions.Compiled | RegexOptions.IgnoreCase);

        // Define a test string.        
        string text = "The the quick brown fox  fox jumped over the lazy dog dog.";

        // Find matches.
        MatchCollection matches = rx.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found in:\n   {1}", 
                          matches.Count, 
                          text);

        // Report on each match.
        foreach (Match match in matches)
        {
            GroupCollection groups = match.Groups;
            Console.WriteLine("'{0}' repeated at positions {1} and {2}",  
                              groups["word"].Value, 
                              groups[0].Index, 
                              groups[1].Index);
        }

    }
	
}
// The example produces the following output to the console:
//       3 matches found in:
//          The the quick brown fox  fox jumped over the lazy dog dog.
//       'The' repeated at positions 0 and 4
//       'fox' repeated at positions 20 and 25
//       'dog' repeated at positions 50 and 54


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft