Regex.IsMatch メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
正規表現が入力文字列内の一致を検出するかどうかを示します。
オーバーロード
| 名前 | 説明 |
|---|---|
| IsMatch(String, String, RegexOptions, TimeSpan) |
指定した正規表現が、指定した一致するオプションとタイムアウト間隔を使用して、指定した入力文字列内の一致を検索するかどうかを示します。 |
| IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) |
指定した正規表現が、指定した一致するオプションとタイムアウト間隔を使用して、指定した入力スパンで一致を検索するかどうかを示します。 |
| IsMatch(String, String, RegexOptions) |
指定した正規表現が、指定した一致するオプションを使用して、指定した入力文字列内の一致を検索するかどうかを示します。 |
| IsMatch(ReadOnlySpan<Char>, String, RegexOptions) |
指定した正規表現が、指定した一致するオプションを使用して、指定した入力スパン内の一致を検索するかどうかを示します。 |
| IsMatch(String, String) |
指定した正規表現が、指定した入力文字列内の一致を検出するかどうかを示します。 |
| IsMatch(ReadOnlySpan<Char>, Int32) |
Regex コンストラクターで指定された正規表現が、指定した位置から指定した入力スパン内の一致を検索するかどうかを示します。 |
| IsMatch(ReadOnlySpan<Char>, String) |
指定した正規表現が、指定した入力スパン内の一致を見つけるかどうかを示します。 |
| IsMatch(String, Int32) |
Regex コンストラクターで指定された正規表現が、文字列内の指定した開始位置から始まる、指定した入力文字列内の一致を検索するかどうかを示します。 |
| IsMatch(String) |
Regex コンストラクターで指定された正規表現が、指定した入力文字列内の一致を検出するかどうかを示します。 |
| IsMatch(ReadOnlySpan<Char>) |
Regex コンストラクターで指定された正規表現が、指定した入力スパン内の一致を検出するかどうかを示します。 |
IsMatch(String, String, RegexOptions, TimeSpan)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
指定した正規表現が、指定した一致するオプションとタイムアウト間隔を使用して、指定した入力文字列内の一致を検索するかどうかを示します。
public:
static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> bool
Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean
パラメーター
- input
- String
一致を検索する文字列。
- pattern
- String
照合する正規表現パターン。
- options
- RegexOptions
一致するオプションを提供する列挙値のビットごとの組み合わせ。
- matchTimeout
- TimeSpan
タイムアウト間隔、またはメソッドがタイムアウトしないことを示す InfiniteMatchTimeout 。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
正規表現解析エラーが発生しました。
input または pattern が null。
options が有効な RegexOptions 値ではありません。
または、 matchTimeout が負、ゼロ、または約 24 日を超えています。
タイムアウトが発生しました。
注釈
IsMatch(String, String, RegexOptions, TimeSpan) メソッドは、通常、文字列を検証したり、後続の操作のためにその文字列を取得せずに文字列が特定のパターンに準拠していることを確認したりするために使用されます。 一致する文字列を取得するには、代わりに Match(String, String, RegexOptions, TimeSpan) または Matches(String, String, RegexOptions, TimeSpan) メソッドを呼び出します。
静的 IsMatch(String, String, RegexOptions, TimeSpan) メソッドは、指定したパターンとオプションを使用して Regex オブジェクトを構築し、 IsMatch(String) インスタンス メソッドを呼び出すことと同じです。 パターンは、正規表現エンジンによって迅速に取得するためにキャッシュされます。
matchTimeout パラメーターは、パターン マッチング メソッドがタイムアウトするまでの一致の検索を試行する期間を指定します。タイムアウト間隔を設定すると、過剰なバックトラッキングに依存する正規表現が、近い一致を含む入力を処理するときに応答を停止するように見えるのを防ぐことができます。 その時間間隔で一致するものが見つからない場合、メソッドは RegexMatchTimeoutException 例外をスローします。
matchTimeout は、メソッドが実行されるアプリケーション ドメインに対して定義されている既定のタイムアウト値をオーバーライドします。
注意 (呼び出し元)
matchTimeout パラメーターを適切な値 (2 秒など) に設定することをお勧めします。
InfiniteMatchTimeoutを指定してタイムアウトを無効にすると、正規表現エンジンのパフォーマンスが若干向上します。 ただし、タイムアウトは次の条件でのみ無効にする必要があります。
正規表現によって処理される入力が既知の信頼できるソースから派生した場合、または静的テキストで構成されている場合。 これにより、ユーザーによって動的に入力されたテキストが除外されます。
正規表現パターンが十分にテストされ、一致、一致しない、および近い一致が効率的に処理されるようにする場合。
正規表現パターンに、近い一致を処理するときに過剰なバックトラッキングを引き起こすことがわかっている言語要素が含まれている場合。
こちらもご覧ください
適用対象
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
指定した正規表現が、指定した一致するオプションとタイムアウト間隔を使用して、指定した入力スパンで一致を検索するかどうかを示します。
public:
static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> bool
Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean
パラメーター
- input
- ReadOnlySpan<Char>
一致を検索するスパン。
- pattern
- String
照合する正規表現パターン。
- options
- RegexOptions
一致するオプションを提供する列挙値のビットごとの組み合わせ。
- matchTimeout
- TimeSpan
タイムアウト間隔、またはメソッドがタイムアウトしないことを示す InfiniteMatchTimeout 。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
正規表現解析エラーが発生しました。
pattern は nullです。
タイムアウトが発生しました。
options が有効な RegexOptions 値ではありません。または、 matchTimeout が負、ゼロ、または約 24 日を超えています。
適用対象
IsMatch(String, String, RegexOptions)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
指定した正規表現が、指定した一致するオプションを使用して、指定した入力文字列内の一致を検索するかどうかを示します。
public:
static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);
public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);
static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions -> bool
Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions) As Boolean
パラメーター
- input
- String
一致を検索する文字列。
- pattern
- String
照合する正規表現パターン。
- options
- RegexOptions
一致するオプションを提供する列挙値のビットごとの組み合わせ。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
正規表現解析エラーが発生しました。
input または pattern が null。
options が有効な RegexOptions 値ではありません。
タイムアウトが発生しました。
注釈
IsMatch(String, String, RegexOptions) メソッドは、通常、文字列を検証したり、後続の操作のためにその文字列を取得せずに文字列が特定のパターンに準拠していることを確認したりするために使用されます。 一致する文字列を取得するには、代わりに Match(String, String, RegexOptions) または Matches(String, String, RegexOptions) メソッドを呼び出します。
静的 IsMatch(String, String, RegexOptions) メソッドは、指定したパターンとオプションを使用して Regex オブジェクトを構築し、 IsMatch(String) インスタンス メソッドを呼び出すことと同じです。 パターンは、正規表現エンジンによって迅速に取得するためにキャッシュされます。
注意 (呼び出し元)
このメソッドは、呼び出されるアプリケーション ドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。 アプリケーション ドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる InfiniteMatchTimeout値が使用されます。 パターンの一致を確認するための推奨される静的メソッドは IsMatch(String, String, RegexOptions, TimeSpan)であり、タイムアウト間隔を設定できます。
こちらもご覧ください
適用対象
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
指定した正規表現が、指定した一致するオプションを使用して、指定した入力スパン内の一致を検索するかどうかを示します。
public:
static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);
public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options);
static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions -> bool
Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Boolean
パラメーター
- input
- ReadOnlySpan<Char>
一致を検索するスパン。
- pattern
- String
照合する正規表現パターン。
- options
- RegexOptions
一致するオプションを提供する列挙値のビットごとの組み合わせ。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
正規表現解析エラーが発生しました。
pattern は nullです。
タイムアウトが発生しました。
options が有効な RegexOptions 値ではありません。
適用対象
IsMatch(String, String)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
指定した正規表現が、指定した入力文字列内の一致を検出するかどうかを示します。
public:
static bool IsMatch(System::String ^ input, System::String ^ pattern);
public static bool IsMatch(string input, string pattern);
static member IsMatch : string * string -> bool
Public Shared Function IsMatch (input As String, pattern As String) As Boolean
パラメーター
- input
- String
一致を検索する文字列。
- pattern
- String
照合する正規表現パターン。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
正規表現解析エラーが発生しました。
input または pattern が null。
タイムアウトが発生しました。
注釈
IsMatch(String, String) メソッドは、通常、文字列を検証したり、後続の操作のためにその文字列を取得せずに文字列が特定のパターンに準拠していることを確認したりするために使用されます。 一致する文字列を取得するには、代わりに Match(String, String) または Matches(String, String) メソッドを呼び出します。
静的 IsMatch(String, String) メソッドは、指定したパターンで Regex オブジェクトを構築し、 IsMatch(String) インスタンス メソッドを呼び出すことと同じです。 パターンは、正規表現エンジンによって迅速に取得するためにキャッシュされます。
注意 (呼び出し元)
このメソッドは、メソッドが呼び出されるアプリケーション ドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。 アプリケーション ドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる InfiniteMatchTimeout値が使用されます。 パターンの一致を確認するための推奨される静的メソッドは IsMatch(String, String, RegexOptions, TimeSpan)であり、タイムアウト間隔を設定できます。
こちらもご覧ください
適用対象
IsMatch(ReadOnlySpan<Char>, Int32)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
Regex コンストラクターで指定された正規表現が、指定した位置から指定した入力スパン内の一致を検索するかどうかを示します。
public:
bool IsMatch(ReadOnlySpan<char> input, int startat);
public bool IsMatch(ReadOnlySpan<char> input, int startat);
member this.IsMatch : ReadOnlySpan<char> * int -> bool
Public Function IsMatch (input As ReadOnlySpan(Of Char), startat As Integer) As Boolean
パラメーター
- input
- ReadOnlySpan<Char>
一致を検索するスパン。
- startat
- Int32
検索を開始する位置を 0 から始める文字位置。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
タイムアウトが発生しました。
適用対象
IsMatch(ReadOnlySpan<Char>, String)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
指定した正規表現が、指定した入力スパン内の一致を見つけるかどうかを示します。
public:
static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern);
public static bool IsMatch(ReadOnlySpan<char> input, string pattern);
static member IsMatch : ReadOnlySpan<char> * string -> bool
Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String) As Boolean
パラメーター
- input
- ReadOnlySpan<Char>
一致を検索するスパン。
- pattern
- String
照合する正規表現パターン。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
正規表現解析エラーが発生しました。
pattern は nullです。
タイムアウトが発生しました。
適用対象
IsMatch(String, Int32)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
Regex コンストラクターで指定された正規表現が、文字列内の指定した開始位置から始まる、指定した入力文字列内の一致を検索するかどうかを示します。
public:
bool IsMatch(System::String ^ input, int startat);
public bool IsMatch(string input, int startat);
member this.IsMatch : string * int -> bool
Public Function IsMatch (input As String, startat As Integer) As Boolean
パラメーター
- input
- String
一致を検索する文字列。
- startat
- Int32
検索を開始する位置を指定します。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
input は nullです。
startat が 0 より小さいか、 inputの長さより大きい値です。
タイムアウトが発生しました。
注釈
IsMatch(String, Int32) メソッドは、通常、文字列を検証したり、後続の操作のためにその文字列を取得せずに文字列が特定のパターンに準拠していることを確認したりするために使用されます。 一致する文字列を取得するには、代わりに Match(String, Int32) または Matches(String, Int32) メソッドを呼び出します。
startatの詳細については、Match(String, Int32)の解説を参照してください。
こちらもご覧ください
適用対象
IsMatch(String)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
Regex コンストラクターで指定された正規表現が、指定した入力文字列内の一致を検出するかどうかを示します。
public:
bool IsMatch(System::String ^ input);
public bool IsMatch(string input);
member this.IsMatch : string -> bool
Public Function IsMatch (input As String) As Boolean
パラメーター
- input
- String
一致を検索する文字列。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
input は nullです。
タイムアウトが発生しました。
注釈
IsMatch(String) メソッドは、通常、文字列を検証したり、後続の操作のためにその文字列を取得せずに文字列が特定のパターンに準拠していることを確認したりするために使用されます。 1 つ以上の文字列が正規表現パターンと一致するかどうかを判断し、後続の操作のためにそれらを取得するには、 Match(String) メソッドまたは Matches(String) メソッドを呼び出します。
一致する操作の実行時間が、RegexMatchTimeoutException コンストラクターで指定されたタイムアウト間隔を超えると、Regex(String, RegexOptions, TimeSpan)例外がスローされます。 コンストラクターを呼び出すときにタイムアウト間隔を設定しない場合、 Regex オブジェクトが作成されるアプリケーション ドメインに対して確立されたタイムアウト値を操作が超えると、例外がスローされます。 Regex コンストラクター呼び出しまたはアプリケーション ドメインのプロパティでタイムアウトが定義されていない場合、またはタイムアウト値がInfiniteMatchTimeout場合、例外はスローされません。
こちらもご覧ください
適用対象
IsMatch(ReadOnlySpan<Char>)
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
- ソース:
- Regex.Match.cs
Regex コンストラクターで指定された正規表現が、指定した入力スパン内の一致を検出するかどうかを示します。
public:
bool IsMatch(ReadOnlySpan<char> input);
public bool IsMatch(ReadOnlySpan<char> input);
member this.IsMatch : ReadOnlySpan<char> -> bool
Public Function IsMatch (input As ReadOnlySpan(Of Char)) As Boolean
パラメーター
- input
- ReadOnlySpan<Char>
一致を検索するスパン。
返品
true 正規表現で一致するものが見つかる場合は 〗。それ以外の場合は false。
例外
タイムアウトが発生しました。