Regex.Matches Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wyszukuje ciąg wejściowy dla wszystkich wystąpień wyrażenia regularnego i zwraca wszystkie dopasowania.
Przeciążenia
| Nazwa | Opis |
|---|---|
| Matches(String, String, RegexOptions, TimeSpan) |
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień określonego wyrażenia regularnego przy użyciu określonych opcji dopasowania i interwału limitu czasu. |
| Matches(String, String, RegexOptions) |
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień określonego wyrażenia regularnego przy użyciu określonych opcji dopasowania. |
| Matches(String, Int32) |
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień wyrażenia regularnego, zaczynając od określonej pozycji początkowej w ciągu. |
| Matches(String) |
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień wyrażenia regularnego. |
| Matches(String, String) |
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień określonego wyrażenia regularnego. |
Matches(String, String, RegexOptions, TimeSpan)
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień określonego wyrażenia regularnego przy użyciu określonych opcji dopasowania i interwału limitu czasu.
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
Parametry
- input
- String
Ciąg do wyszukiwania dopasowania.
- pattern
- String
Wzorzec wyrażenia regularnego do dopasowania.
- options
- RegexOptions
Bitowa kombinacja wartości wyliczenia, które określają opcje dopasowania.
- matchTimeout
- TimeSpan
Interwał przekroczenia limitu czasu lub InfiniteMatchTimeout wskazujący, że metoda nie powinna upłynął limit czasu.
Zwraca
Kolekcja Match obiektów znalezionych przez wyszukiwanie. Jeśli nie znaleziono dopasowań, metoda zwraca pusty obiekt kolekcji.
Wyjątki
Wystąpił błąd analizowania wyrażeń regularnych.
input lub pattern ma wartość null.
options nie jest prawidłową kombinacją RegexOptions bitową wartości.
-or- matchTimeout jest ujemny, zero lub większy niż około 24 dni.
Uwagi
Metoda jest podobna Matches(String, String, RegexOptions, TimeSpan) do Match(String, String, RegexOptions, TimeSpan) metody, z tą różnicą, że zwraca informacje o wszystkich dopasowaniach znalezionych w ciągu wejściowym zamiast pojedynczego dopasowania.
Metody statyczne Matches są równoważne konstruowaniu Regex obiektu z określonym wzorcem wyrażenia regularnego i wywoływaniem metody Matcheswystąpienia .
Metoda Matches(String, String, RegexOptions, TimeSpan) używa opóźnionej oceny, aby wypełnić zwrócony MatchCollection obiekt. Uzyskiwanie dostępu do elementów członkowskich tej kolekcji, takich jak Count i CopyTo(Array, Int32) powoduje natychmiastowe wypełnienie kolekcji. Aby skorzystać z leniwej oceny, iteruj kolekcję przy użyciu metody foreach.
Ze względu na leniwą ocenę wywołanie Matches(String, String, RegexOptions, TimeSpan) metody nie zgłasza wyjątku RegexMatchTimeoutException . Jednak wyjątek jest zgłaszany, gdy operacja jest wykonywana na MatchCollection obiekcie zwróconym przez tę metodę, jeśli pasujący interwał przekracza interwał limitu czasu określony przez matchTimeout parametr .
Notatki dotyczące wywoływania
Zalecamy ustawienie parametru matchTimeout na odpowiednią wartość, na przykład dwie sekundy. Jeśli wyłączysz limity czasu, określając InfiniteMatchTimeoutwartość , aparat wyrażeń regularnych zapewnia nieco lepszą wydajność. Należy jednak wyłączyć limity czasu tylko w następujących warunkach:
Gdy dane wejściowe przetwarzane przez wyrażenie regularne pochodzą ze znanego i zaufanego źródła lub składa się z tekstu statycznego. Wyklucza to tekst, który został dynamicznie wprowadzany przez użytkowników.
Gdy wzorzec wyrażenia regularnego został dokładnie przetestowany w celu zapewnienia, że efektywnie obsługuje dopasowania, niezgodne i bliskie dopasowania.
Gdy wzorzec wyrażenia regularnego nie zawiera żadnych elementów języka, które są znane, aby powodować nadmierne wycofywanie podczas przetwarzania niemal zgodnego.
Zobacz też
Dotyczy
Matches(String, String, RegexOptions)
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień określonego wyrażenia regularnego przy użyciu określonych opcji dopasowania.
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
Parametry
- input
- String
Ciąg do wyszukiwania dopasowania.
- pattern
- String
Wzorzec wyrażenia regularnego do dopasowania.
- options
- RegexOptions
Bitowa kombinacja wartości wyliczenia, które określają opcje dopasowania.
Zwraca
Kolekcja Match obiektów znalezionych przez wyszukiwanie. Jeśli nie znaleziono dopasowań, metoda zwraca pusty obiekt kolekcji.
Wyjątki
Wystąpił błąd analizowania wyrażeń regularnych.
input lub pattern ma wartość null.
options nie jest prawidłową kombinacją RegexOptions bitową wartości.
Uwagi
Metoda jest podobna Matches(String, String, RegexOptions) do Match(String, String, RegexOptions) metody, z tą różnicą, że zwraca informacje o wszystkich dopasowaniach znalezionych w ciągu wejściowym zamiast pojedynczego dopasowania.
Metody statyczne Matches są równoważne konstruowaniu Regex obiektu z określonym wzorcem wyrażenia regularnego i wywoływaniem metody Matcheswystąpienia .
Metoda Matches(String, String, RegexOptions) używa opóźnionej oceny, aby wypełnić zwrócony MatchCollection obiekt. Uzyskiwanie dostępu do elementów członkowskich tej kolekcji, takich jak Count i CopyTo(Array, Int32) powoduje natychmiastowe wypełnienie kolekcji. Aby skorzystać z leniwej oceny, iteruj kolekcję przy użyciu metody foreach.
Ze względu na leniwą ocenę wywołanie Matches(String, String, RegexOptions) metody nie zgłasza wyjątku RegexMatchTimeoutException . Jednak wyjątek jest zgłaszany, gdy operacja jest wykonywana na MatchCollection obiekcie zwróconym przez tę metodę, jeśli pasująca operacja przekracza interwał limitu czasu.
Notatki dotyczące wywoływania
Ta metoda powoduje przekroczenie limitu czasu po interwale równym domyślnej wartości limitu czasu domeny aplikacji, w której jest wywoływana. Jeśli dla domeny aplikacji nie zdefiniowano wartości limitu czasu, zostanie użyta wartość InfiniteMatchTimeout, która uniemożliwia przekroczenie limitu czasu metody. Zalecaną metodą statyczną pobierania wielu dopasowań wzorca jest Matches(String, String, RegexOptions, TimeSpan), która umożliwia ustawienie interwału limitu czasu.
Zobacz też
Dotyczy
Matches(String, Int32)
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień wyrażenia regularnego, zaczynając od określonej pozycji początkowej w ciągu.
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
Parametry
- input
- String
Ciąg do wyszukiwania dopasowania.
- startat
- Int32
Pozycja znaku w ciągu wejściowym, w którym ma być uruchamiane wyszukiwanie.
Zwraca
Kolekcja Match obiektów znalezionych przez wyszukiwanie. Jeśli nie znaleziono dopasowań, metoda zwraca pusty obiekt kolekcji.
Wyjątki
Parametr input ma wartość null.
startat wartość jest mniejsza niż zero lub większa niż długość input.
Uwagi
Metoda jest podobna Matches(String, Int32) do Match(String, Int32) metody, z tą różnicą, że zwraca informacje o wszystkich dopasowaniach znalezionych w ciągu wejściowym zamiast pojedynczego dopasowania.
Aby uzyskać więcej informacji na temat startatprogramu , zobacz uwagi dotyczące Match(String, Int32)programu .
Metoda Matches(String, Int32) używa opóźnionej oceny, aby wypełnić zwrócony MatchCollection obiekt. Uzyskiwanie dostępu do elementów członkowskich tej kolekcji, takich jak Count i CopyTo(Array, Int32) powoduje natychmiastowe wypełnienie kolekcji. Aby skorzystać z leniwej oceny, iteruj kolekcję przy użyciu metody foreach.
Ze względu na leniwą ocenę wywołanie Matches(String, Int32) metody nie zgłasza wyjątku RegexMatchTimeoutException . Jednak wyjątek jest zgłaszany, gdy operacja jest wykonywana na MatchCollection obiekcie zwróconym przez tę metodę, jeśli MatchTimeout właściwość nie InfiniteMatchTimeout jest, a zgodna operacja przekracza interwał limitu czasu.
Zobacz też
Dotyczy
Matches(String)
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień wyrażenia regularnego.
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
Parametry
- input
- String
Ciąg do wyszukiwania dopasowania.
Zwraca
Kolekcja Match obiektów znalezionych przez wyszukiwanie. Jeśli nie znaleziono dopasowań, metoda zwraca pusty obiekt kolekcji.
Wyjątki
Parametr input ma wartość null.
Uwagi
Metoda jest podobna Matches(String) do Match(String) metody, z tą różnicą, że zwraca informacje o wszystkich dopasowaniach znalezionych w ciągu wejściowym zamiast pojedynczego dopasowania. Kolekcja zawiera tylko dopasowania i kończy się przy pierwszym niezgodności.
Metoda Matches(String) używa opóźnionej oceny, aby wypełnić zwrócony MatchCollection obiekt. Uzyskiwanie dostępu do elementów członkowskich tej kolekcji, takich jak Count i CopyTo(Array, Int32) powoduje natychmiastowe wypełnienie kolekcji. Aby skorzystać z leniwej oceny, iteruj kolekcję przy użyciu metody foreach.
Ze względu na leniwą ocenę wywołanie Matches(String) metody nie zgłasza wyjątku RegexMatchTimeoutException . Jednak wyjątek jest zgłaszany, gdy operacja jest wykonywana na MatchCollection obiekcie zwróconym przez tę metodę, jeśli MatchTimeout właściwość nie InfiniteMatchTimeout jest, a zgodna operacja przekracza interwał limitu czasu.
Zobacz też
Dotyczy
Matches(String, String)
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
- Źródło:
- Regex.Match.cs
Wyszukuje określony ciąg wejściowy dla wszystkich wystąpień określonego wyrażenia regularnego.
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
Parametry
- input
- String
Ciąg do wyszukiwania dopasowania.
- pattern
- String
Wzorzec wyrażenia regularnego do dopasowania.
Zwraca
Kolekcja Match obiektów znalezionych przez wyszukiwanie. Jeśli nie znaleziono dopasowań, metoda zwraca pusty obiekt kolekcji.
Wyjątki
Wystąpił błąd analizowania wyrażeń regularnych.
input lub pattern ma wartość null.
Uwagi
Metoda jest podobna Matches(String, String) do Match(String, String) metody, z tą różnicą, że zwraca informacje o wszystkich dopasowaniach znalezionych w ciągu wejściowym zamiast pojedynczego dopasowania.
Metody statyczne Matches są równoważne konstruowaniu Regex obiektu z określonym wzorcem wyrażenia regularnego i wywoływaniem metody Matcheswystąpienia .
Metoda Matches(String, String) używa opóźnionej oceny, aby wypełnić zwrócony MatchCollection obiekt. Uzyskiwanie dostępu do elementów członkowskich tej kolekcji, takich jak Count i CopyTo(Array, Int32) powoduje natychmiastowe wypełnienie kolekcji. Aby skorzystać z leniwej oceny, iteruj kolekcję przy użyciu metody foreach.
Ze względu na leniwą ocenę wywołanie Matches(String, String) metody nie zgłasza wyjątku RegexMatchTimeoutException . Jednak wyjątek jest zgłaszany, gdy operacja jest wykonywana na MatchCollection obiekcie zwróconym przez tę metodę, jeśli pasująca operacja przekracza interwał limitu czasu.
Notatki dotyczące wywoływania
Ta metoda powoduje przekroczenie limitu czasu po interwale równym domyślnej wartości limitu czasu domeny aplikacji, w której jest wywoływana. Jeśli dla domeny aplikacji nie zdefiniowano wartości limitu czasu, zostanie użyta wartość InfiniteMatchTimeout, która uniemożliwia przekroczenie limitu czasu metody. Zalecaną metodą statyczną pobierania wielu dopasowań wzorca jest Matches(String, String, RegexOptions, TimeSpan), która umożliwia określenie interwału limitu czasu.