Regex.Matches Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет поиск входной строки для всех вхождения регулярного выражения и возвращает все совпадения.
Перегрузки
| Имя | Описание |
|---|---|
| Matches(String, String, RegexOptions, TimeSpan) |
Выполняет поиск указанной входной строки для всех вхождения указанного регулярного выражения, используя указанные параметры сопоставления и интервал времени ожидания. |
| Matches(String, String, RegexOptions) |
Выполняет поиск указанной входной строки для всех вхождения указанного регулярного выражения с помощью указанных параметров сопоставления. |
| Matches(String, Int32) |
Выполняет поиск указанной входной строки для всех вхождения регулярного выражения, начиная с указанной начальной позиции в строке. |
| Matches(String) |
Выполняет поиск указанной входной строки для всех вхождения регулярного выражения. |
| Matches(String, String) |
Выполняет поиск указанной входной строки для всех вхождения указанного регулярного выражения. |
Matches(String, String, RegexOptions, TimeSpan)
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
Выполняет поиск указанной входной строки для всех вхождения указанного регулярного выражения, используя указанные параметры сопоставления и интервал времени ожидания.
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.MatchCollectionPublic Shared Function Matches (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As MatchCollectionПараметры
- input
- String
Строка для поиска совпадения.
- pattern
- String
Шаблон регулярного выражения, соответствующий.
- options
- RegexOptions
Побитовое сочетание значений перечисления, указывающее параметры сопоставления.
- matchTimeout
- TimeSpan
Интервал времени ожидания или InfiniteMatchTimeout указание, что метод не должен истекать.
Возвращаемое значение
Коллекция объектов, Match найденных поиском. Если совпадения не найдены, метод возвращает пустой объект коллекции.
Исключения
Произошла ошибка синтаксического анализа регулярных выражений.
input или pattern есть null.
options не является допустимым побитовой комбинацией значений RegexOptions .
-или- matchTimeout отрицательно, ноль или больше примерно 24 дней.
Комментарии
Метод Matches(String, String, RegexOptions, TimeSpan) аналогичен Match(String, String, RegexOptions, TimeSpan) методу, за исключением того, что он возвращает сведения обо всех совпадениях, найденных в входной строке, вместо одного совпадения.
Статические Matches методы эквивалентны созданию Regex объекта с указанным шаблоном регулярного выражения и вызовом метода Matchesэкземпляра.
Метод Matches(String, String, RegexOptions, TimeSpan) использует отложенную оценку для заполнения возвращаемого MatchCollection объекта. Доступ к членам этой коллекции, например Count и CopyTo(Array, Int32) приводит к немедленному заполнению коллекции. Чтобы воспользоваться преимуществами отложенной оценки, выполните итерацию коллекции с помощью foreach.
Из-за отложенной оценки вызов Matches(String, String, RegexOptions, TimeSpan) метода не вызывает RegexMatchTimeoutException исключения. Однако исключение возникает при выполнении операции с MatchCollection объектом, возвращаемым этим методом, если операция сопоставления превышает интервал времени ожидания, указанный параметром matchTimeout .
Примечания для тех, кто вызывает этот метод
Рекомендуется задать matchTimeout для параметра соответствующее значение, например две секунды. Если вы отключаете время ожидания, указывая InfiniteMatchTimeout, подсистема регулярных выражений обеспечивает немного лучшую производительность. Однако вы должны отключить тайм-аут только в следующих условиях:
Если входные данные, обработанные регулярным выражением, являются производными от известного и доверенного источника или состоят из статического текста. Это исключает текст, динамически введенный пользователями.
При тщательном тестировании шаблона регулярного выражения для эффективной обработки совпадений, не совпадающих и близких совпадений.
Если шаблон регулярного выражения не содержит языковых элементов, которые, как известно, вызывают чрезмерную обратную дорожку при обработке близкого совпадения.
См. также раздел
Применяется к
Matches(String, String, RegexOptions)
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
Выполняет поиск указанной входной строки для всех вхождения указанного регулярного выражения с помощью указанных параметров сопоставления.
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.MatchCollectionPublic Shared Function Matches (input As String, pattern As String, options As RegexOptions) As MatchCollectionПараметры
- input
- String
Строка для поиска совпадения.
- pattern
- String
Шаблон регулярного выражения, соответствующий.
- options
- RegexOptions
Побитовое сочетание значений перечисления, указывающее параметры сопоставления.
Возвращаемое значение
Коллекция объектов, Match найденных поиском. Если совпадения не найдены, метод возвращает пустой объект коллекции.
Исключения
Произошла ошибка синтаксического анализа регулярных выражений.
input или pattern есть null.
options не является допустимым побитовой комбинацией значений RegexOptions .
Комментарии
Метод Matches(String, String, RegexOptions) аналогичен Match(String, String, RegexOptions) методу, за исключением того, что он возвращает сведения обо всех совпадениях, найденных в входной строке, вместо одного совпадения.
Статические Matches методы эквивалентны созданию Regex объекта с указанным шаблоном регулярного выражения и вызовом метода Matchesэкземпляра.
Метод Matches(String, String, RegexOptions) использует отложенную оценку для заполнения возвращаемого MatchCollection объекта. Доступ к членам этой коллекции, например Count и CopyTo(Array, Int32) приводит к немедленному заполнению коллекции. Чтобы воспользоваться преимуществами отложенной оценки, выполните итерацию коллекции с помощью foreach.
Из-за отложенной оценки вызов Matches(String, String, RegexOptions) метода не вызывает RegexMatchTimeoutException исключения. Однако исключение возникает при выполнении операции с MatchCollection объектом, возвращаемым этим методом, если операция сопоставления превышает интервал времени ожидания.
Примечания для тех, кто вызывает этот метод
Этот метод истекает после интервала, равного значению времени ожидания по умолчанию домена приложения, в котором он вызывается. Если значение времени ожидания не определено для домена приложения, используется значение InfiniteMatchTimeout, которое предотвращает истечение времени ожидания метода. Рекомендуемый статический метод для получения нескольких совпадений шаблонов— Matches(String, String, RegexOptions, TimeSpan)это позволяет задать интервал времени ожидания.
См. также раздел
Применяется к
Matches(String, Int32)
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
Выполняет поиск указанной входной строки для всех вхождения регулярного выражения, начиная с указанной начальной позиции в строке.
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.MatchCollectionPublic Function Matches (input As String, startat As Integer) As MatchCollectionПараметры
- input
- String
Строка для поиска совпадения.
- startat
- Int32
Позиция символа во входной строке, с которой следует запустить поиск.
Возвращаемое значение
Коллекция объектов, Match найденных поиском. Если совпадения не найдены, метод возвращает пустой объект коллекции.
Исключения
input равно null.
startat меньше нуля или больше длины input.
Комментарии
Метод Matches(String, Int32) аналогичен Match(String, Int32) методу, за исключением того, что он возвращает сведения обо всех совпадениях, найденных в входной строке, вместо одного совпадения.
Дополнительные сведения смstartat. в примечаниях.Match(String, Int32)
Метод Matches(String, Int32) использует отложенную оценку для заполнения возвращаемого MatchCollection объекта. Доступ к членам этой коллекции, например Count и CopyTo(Array, Int32) приводит к немедленному заполнению коллекции. Чтобы воспользоваться преимуществами отложенной оценки, выполните итерацию коллекции с помощью foreach.
Из-за отложенной оценки вызов Matches(String, Int32) метода не вызывает RegexMatchTimeoutException исключения. Однако исключение возникает, когда операция выполняется для MatchCollection объекта, возвращаемого этим методом, если MatchTimeout свойство не InfiniteMatchTimeout является, а операция сопоставления превышает интервал времени ожидания.
См. также раздел
Применяется к
Matches(String)
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
Выполняет поиск указанной входной строки для всех вхождения регулярного выражения.
public:
System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input);public System.Text.RegularExpressions.MatchCollection Matches(string input);member this.Matches : string -> System.Text.RegularExpressions.MatchCollectionPublic Function Matches (input As String) As MatchCollectionПараметры
- input
- String
Строка для поиска совпадения.
Возвращаемое значение
Коллекция объектов, Match найденных поиском. Если совпадения не найдены, метод возвращает пустой объект коллекции.
Исключения
input равно null.
Комментарии
Метод Matches(String) аналогичен Match(String) методу, за исключением того, что он возвращает сведения обо всех совпадениях, найденных в входной строке, вместо одного совпадения. Коллекция включает только совпадения и завершается при первом несоответствии.
Метод Matches(String) использует отложенную оценку для заполнения возвращаемого MatchCollection объекта. Доступ к членам этой коллекции, например Count и CopyTo(Array, Int32) приводит к немедленному заполнению коллекции. Чтобы воспользоваться преимуществами отложенной оценки, выполните итерацию коллекции с помощью foreach.
Из-за отложенной оценки вызов Matches(String) метода не вызывает RegexMatchTimeoutException исключения. Однако исключение возникает, когда операция выполняется для MatchCollection объекта, возвращаемого этим методом, если MatchTimeout свойство не InfiniteMatchTimeout является, а операция сопоставления превышает интервал времени ожидания.
См. также раздел
Применяется к
Matches(String, String)
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
- Исходный код:
- Regex.Match.cs
Выполняет поиск указанной входной строки для всех вхождения указанного регулярного выражения.
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.MatchCollectionPublic Shared Function Matches (input As String, pattern As String) As MatchCollectionПараметры
- input
- String
Строка для поиска совпадения.
- pattern
- String
Шаблон регулярного выражения, соответствующий.
Возвращаемое значение
Коллекция объектов, Match найденных поиском. Если совпадения не найдены, метод возвращает пустой объект коллекции.
Исключения
Произошла ошибка синтаксического анализа регулярных выражений.
input или pattern есть null.
Комментарии
Метод Matches(String, String) аналогичен Match(String, String) методу, за исключением того, что он возвращает сведения обо всех совпадениях, найденных в входной строке, вместо одного совпадения.
Статические Matches методы эквивалентны созданию Regex объекта с указанным шаблоном регулярного выражения и вызовом метода Matchesэкземпляра.
Метод Matches(String, String) использует отложенную оценку для заполнения возвращаемого MatchCollection объекта. Доступ к членам этой коллекции, например Count и CopyTo(Array, Int32) приводит к немедленному заполнению коллекции. Чтобы воспользоваться преимуществами отложенной оценки, выполните итерацию коллекции с помощью foreach.
Из-за отложенной оценки вызов Matches(String, String) метода не вызывает RegexMatchTimeoutException исключения. Однако исключение возникает при выполнении операции с MatchCollection объектом, возвращаемым этим методом, если операция сопоставления превышает интервал времени ожидания.
Примечания для тех, кто вызывает этот метод
Этот метод истекает после интервала, равного значению времени ожидания по умолчанию домена приложения, в котором он вызывается. Если значение времени ожидания не определено для домена приложения, используется значение InfiniteMatchTimeout, которое предотвращает истечение времени ожидания метода. Рекомендуемый статический метод для получения нескольких совпадений шаблонов — Matches(String, String, RegexOptions, TimeSpan)это позволяет указать интервал времени ожидания.
