Regex.Matches Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Busca en una cadena de entrada todas las apariciones de una expresión regular y devuelve todas las coincidencias.
Sobrecargas
| Nombre | Description |
|---|---|
| Matches(String, String, RegexOptions, TimeSpan) |
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular especificada, utilizando las opciones de coincidencia y el intervalo de tiempo de espera especificados. |
| Matches(String, String, RegexOptions) |
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular especificada, utilizando las opciones de coincidencia especificadas. |
| Matches(String, Int32) |
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular, empezando por la posición inicial especificada en la cadena. |
| Matches(String) |
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular. |
| Matches(String, String) |
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular especificada. |
Matches(String, String, RegexOptions, TimeSpan)
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular especificada, utilizando las opciones de coincidencia y el intervalo de tiempo de espera especificados.
public:
static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Matches : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.MatchCollection
Public Shared Function Matches (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As MatchCollection
Parámetros
- input
- String
Cadena que se va a buscar una coincidencia.
- pattern
- String
Patrón de expresión regular que se va a coincidir.
- options
- RegexOptions
Combinación bit a bit de los valores de enumeración que especifican opciones para la coincidencia.
- matchTimeout
- TimeSpan
Intervalo de tiempo de espera o InfiniteMatchTimeout para indicar que el método no debe agotar el tiempo de espera.
Devoluciones
Colección de los Match objetos encontrados por la búsqueda. Si no se encuentra ninguna coincidencia, el método devuelve un objeto de colección vacío.
Excepciones
Error de análisis de expresiones regulares.
input o pattern es null.
options no es una combinación bit a bit válida de RegexOptions valores.
-o bien- matchTimeout es negativo, cero o mayor que aproximadamente 24 días.
Comentarios
El Matches(String, String, RegexOptions, TimeSpan) método es similar al Match(String, String, RegexOptions, TimeSpan) método , salvo que devuelve información sobre todas las coincidencias encontradas en la cadena de entrada, en lugar de una sola coincidencia.
Los métodos estáticos Matches son equivalentes a construir un Regex objeto con el patrón de expresión regular especificado y llamar al método Matchesde instancia .
El Matches(String, String, RegexOptions, TimeSpan) método usa la evaluación diferida para rellenar el objeto devuelto MatchCollection . El acceso a los miembros de esta colección como Count y CopyTo(Array, Int32) hace que la colección se rellene inmediatamente. Para aprovechar la evaluación diferida, itera la colección mediante foreach.
Debido a su evaluación diferida, llamar al Matches(String, String, RegexOptions, TimeSpan) método no produce una RegexMatchTimeoutException excepción. Sin embargo, se produce una excepción cuando se realiza una operación en el MatchCollection objeto devuelto por este método, si una operación coincidente supera el intervalo de tiempo de espera especificado por el matchTimeout parámetro .
Notas a los autores de las llamadas
Se recomienda establecer el matchTimeout parámetro en un valor adecuado, como dos segundos. Si deshabilita los tiempos de espera especificando InfiniteMatchTimeout, el motor de expresiones regulares ofrece un rendimiento ligeramente mejor. Sin embargo, debe deshabilitar los tiempos de espera solo en las condiciones siguientes:
Cuando la entrada procesada por una expresión regular se deriva de un origen conocido y de confianza o consta de texto estático. Esto excluye el texto que los usuarios han introducido dinámicamente.
Cuando el patrón de expresión regular se ha probado exhaustivamente para asegurarse de que controla eficazmente las coincidencias, las no coincide y las coincidencias cercanas.
Cuando el patrón de expresión regular no contiene elementos de lenguaje que se sabe que provocan un retroceso excesivo al procesar una coincidencia cercana.
Consulte también
Se aplica a
Matches(String, String, RegexOptions)
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular especificada, utilizando las opciones de coincidencia especificadas.
public:
static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);
public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);
static member Matches : string * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.MatchCollection
Public Shared Function Matches (input As String, pattern As String, options As RegexOptions) As MatchCollection
Parámetros
- input
- String
Cadena que se va a buscar una coincidencia.
- pattern
- String
Patrón de expresión regular que se va a coincidir.
- options
- RegexOptions
Combinación bit a bit de los valores de enumeración que especifican opciones para la coincidencia.
Devoluciones
Colección de los Match objetos encontrados por la búsqueda. Si no se encuentra ninguna coincidencia, el método devuelve un objeto de colección vacío.
Excepciones
Error de análisis de expresiones regulares.
input o pattern es null.
options no es una combinación bit a bit válida de RegexOptions valores.
Comentarios
El Matches(String, String, RegexOptions) método es similar al Match(String, String, RegexOptions) método , salvo que devuelve información sobre todas las coincidencias encontradas en la cadena de entrada, en lugar de una sola coincidencia.
Los métodos estáticos Matches son equivalentes a construir un Regex objeto con el patrón de expresión regular especificado y llamar al método Matchesde instancia .
El Matches(String, String, RegexOptions) método usa la evaluación diferida para rellenar el objeto devuelto MatchCollection . El acceso a los miembros de esta colección como Count y CopyTo(Array, Int32) hace que la colección se rellene inmediatamente. Para aprovechar la evaluación diferida, itera la colección mediante foreach.
Debido a su evaluación diferida, llamar al Matches(String, String, RegexOptions) método no produce una RegexMatchTimeoutException excepción. Sin embargo, la excepción se produce cuando se realiza una operación en el MatchCollection objeto devuelto por este método, si una operación coincidente supera el intervalo de tiempo de espera.
Notas a los autores de las llamadas
Este método agota el tiempo de espera después de un intervalo que es igual al valor de tiempo de espera predeterminado del dominio de aplicación en el que se llama. Si no se ha definido un valor de tiempo de espera para el dominio de aplicación, se usa el valor InfiniteMatchTimeout, que impide que el método agote el tiempo de espera. El método estático recomendado para recuperar varias coincidencias de patrones es Matches(String, String, RegexOptions, TimeSpan), lo que permite establecer el intervalo de tiempo de espera.
Consulte también
Se aplica a
Matches(String, Int32)
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular, empezando por la posición inicial especificada en la cadena.
public:
System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, int startat);
public System.Text.RegularExpressions.MatchCollection Matches(string input, int startat);
member this.Matches : string * int -> System.Text.RegularExpressions.MatchCollection
Public Function Matches (input As String, startat As Integer) As MatchCollection
Parámetros
- input
- String
Cadena que se va a buscar una coincidencia.
- startat
- Int32
Posición del carácter en la cadena de entrada en la que se va a iniciar la búsqueda.
Devoluciones
Colección de los Match objetos encontrados por la búsqueda. Si no se encuentra ninguna coincidencia, el método devuelve un objeto de colección vacío.
Excepciones
input es null.
startat es menor que cero o mayor que la longitud de input.
Comentarios
El Matches(String, Int32) método es similar al Match(String, Int32) método , salvo que devuelve información sobre todas las coincidencias encontradas en la cadena de entrada, en lugar de una sola coincidencia.
Para obtener más información sobre startat, vea los comentarios de Match(String, Int32).
El Matches(String, Int32) método usa la evaluación diferida para rellenar el objeto devuelto MatchCollection . El acceso a los miembros de esta colección como Count y CopyTo(Array, Int32) hace que la colección se rellene inmediatamente. Para aprovechar la evaluación diferida, itera la colección mediante foreach.
Debido a su evaluación diferida, llamar al Matches(String, Int32) método no produce una RegexMatchTimeoutException excepción. Sin embargo, la excepción se produce cuando se realiza una operación en el MatchCollection objeto devuelto por este método, si la MatchTimeout propiedad no InfiniteMatchTimeout es y una operación coincidente supera el intervalo de tiempo de espera.
Consulte también
Se aplica a
Matches(String)
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular.
public:
System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input);
public System.Text.RegularExpressions.MatchCollection Matches(string input);
member this.Matches : string -> System.Text.RegularExpressions.MatchCollection
Public Function Matches (input As String) As MatchCollection
Parámetros
- input
- String
Cadena que se va a buscar una coincidencia.
Devoluciones
Colección de los Match objetos encontrados por la búsqueda. Si no se encuentra ninguna coincidencia, el método devuelve un objeto de colección vacío.
Excepciones
input es null.
Comentarios
El Matches(String) método es similar al Match(String) método , salvo que devuelve información sobre todas las coincidencias encontradas en la cadena de entrada, en lugar de una sola coincidencia. La colección solo incluye coincidencias y finaliza en la primera no coincidente.
El Matches(String) método usa la evaluación diferida para rellenar el objeto devuelto MatchCollection . El acceso a los miembros de esta colección como Count y CopyTo(Array, Int32) hace que la colección se rellene inmediatamente. Para aprovechar la evaluación diferida, itera la colección mediante foreach.
Debido a su evaluación diferida, llamar al Matches(String) método no produce una RegexMatchTimeoutException excepción. Sin embargo, la excepción se produce cuando se realiza una operación en el MatchCollection objeto devuelto por este método, si la MatchTimeout propiedad no InfiniteMatchTimeout es y una operación coincidente supera el intervalo de tiempo de espera.
Consulte también
Se aplica a
Matches(String, String)
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
- Source:
- Regex.Match.cs
Busca en la cadena de entrada especificada todas las apariciones de una expresión regular especificada.
public:
static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern);
public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern);
static member Matches : string * string -> System.Text.RegularExpressions.MatchCollection
Public Shared Function Matches (input As String, pattern As String) As MatchCollection
Parámetros
- input
- String
Cadena que se va a buscar una coincidencia.
- pattern
- String
Patrón de expresión regular que se va a coincidir.
Devoluciones
Colección de los Match objetos encontrados por la búsqueda. Si no se encuentra ninguna coincidencia, el método devuelve un objeto de colección vacío.
Excepciones
Error de análisis de expresiones regulares.
input o pattern es null.
Comentarios
El Matches(String, String) método es similar al Match(String, String) método , salvo que devuelve información sobre todas las coincidencias encontradas en la cadena de entrada, en lugar de una sola coincidencia.
Los métodos estáticos Matches son equivalentes a construir un Regex objeto con el patrón de expresión regular especificado y llamar al método Matchesde instancia .
El Matches(String, String) método usa la evaluación diferida para rellenar el objeto devuelto MatchCollection . El acceso a los miembros de esta colección como Count y CopyTo(Array, Int32) hace que la colección se rellene inmediatamente. Para aprovechar la evaluación diferida, itera la colección mediante foreach.
Debido a su evaluación diferida, llamar al Matches(String, String) método no produce una RegexMatchTimeoutException excepción. Sin embargo, la excepción se produce cuando se realiza una operación en el MatchCollection objeto devuelto por este método, si una operación coincidente supera el intervalo de tiempo de espera.
Notas a los autores de las llamadas
Este método agota el tiempo de espera después de un intervalo que es igual al valor de tiempo de espera predeterminado del dominio de aplicación en el que se llama. Si no se ha definido un valor de tiempo de espera para el dominio de aplicación, se usa el valor InfiniteMatchTimeout, que impide que el método agote el tiempo de espera. El método estático recomendado para recuperar varias coincidencias de patrones es Matches(String, String, RegexOptions, TimeSpan), lo que le permite especificar el intervalo de tiempo de espera.