Lenguaje

Regex.Matches Método

Definición

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.

Consulte también

Se aplica a