Regex.IsMatch 方法

定义

指示正则表达式是否在输入字符串中找到匹配项。

重载

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)

指示正则表达式构造函数中指定的正则表达式是否在指定的输入范围中找到匹配项。

IsMatch(ReadOnlySpan<Char>, String)

指示指定的正则表达式是否在指定的输入范围中找到匹配项。

IsMatch(String, Int32)

指示在 Regex 构造函数中指定的正则表达式是否在指定的输入字符串中找到匹配项,从字符串中的指定起始位置开始。

IsMatch(String)

指示 Regex 构造函数中指定的正则表达式是否在指定的输入字符串中找到匹配项。

IsMatch(ReadOnlySpan<Char>)

指示正则表达式构造函数中指定的正则表达式是否在指定的输入范围中找到匹配项。

IsMatch(String, String, RegexOptions, TimeSpan)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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

例外

发生正则表达式分析错误。

inputpatternnull

options 不是有效的 RegexOptions 值。

-或-

matchTimeout 为负数、零或大于约 24 天。

发生超时。

示例

下面的示例演示如何使用 IsMatch(String, String, RegexOptions, TimeSpan) 方法来确定字符串是否为有效的部件号。 正则表达式假定部件号具有由连字符分隔的三组字符的特定格式。 第一个集包含四个字符,必须包含字母数字字符,后跟两个数字字符,后跟字母数字字符。 第二个集(由三个字符组成)必须是数字。 第三组由四个字符组成,必须具有三个数字字符,后跟字母数字字符。 匹配正则表达式模式应涉及最少搜索输入字符串,因此该方法设置超时间隔 500 毫秒。

string[] partNumbers = [ "1298-673-4192", "A08Z-931-468a",
                      "_A90-123-129X", "12345-KKA-1230",
                      "0919-2893-1256" ];
string pattern = @"^[A-Z0-9]\d{2}[A-Z0-9](-\d{3}){2}[A-Z0-9]$";
foreach (string partNumber in partNumbers)
    try
    {
        bool isMatch = Regex.IsMatch(partNumber, pattern, RegexOptions.IgnoreCase, TimeSpan.FromMilliseconds(500));
        Console.WriteLine($"{partNumber} {(isMatch ? "is" : "is not")} a valid part number.");
    }
    catch (RegexMatchTimeoutException e)
    {
        Console.WriteLine($"Timeout after {e.MatchTimeout} seconds matching {e.Input}.");
    }

// The example displays the following output:
//       1298-673-4192 is a valid part number.
//       A08Z-931-468a is a valid part number.
//       _A90-123-129X is not a valid part number.
//       12345-KKA-1230 is not a valid part number.
//       0919-2893-1256 is not a valid part number.
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim partNumbers() As String = { "1298-673-4192", "A08Z-931-468a", 
                                      "_A90-123-129X", "12345-KKA-1230", 
                                      "0919-2893-1256" }
      Dim pattern As String = "^[A-Z0-9]\d{2}[A-Z0-9](-\d{3}){2}[A-Z0-9]$"
      For Each partNumber As String In partNumbers
         Try
            Console.WriteLine("{0} {1} a valid part number.", 
                              partNumber, _
                              IIF(Regex.IsMatch(partNumber, pattern, RegexOptions.IgnoreCase), _
                                  "is", "is not"),
                              TimeSpan.FromMilliseconds(500))
         Catch e As RegexMatchTimeoutException
            Console.WriteLine("Timeout after {0} seconds matching {1}.",
                              e.MatchTimeout, e.Input)
         End Try
      Next
   End Sub
End Module
' The example displays the following output:
'       1298-673-4192 is a valid part number.
'       A08Z-931-468a is a valid part number.
'       _A90-123-129X is not a valid part number.
'       12345-KKA-1230 is not a valid part number.
'       0919-2893-1256 is not a valid part number.

正则表达式模式为:

^[A-Z0-9]\d{2}[A-Z0-9](-\d{3}){2}[A-Z0-9]$

下表显示了如何解释正则表达式模式。

模式 描述
^ 在字符串开头开始匹配。
[A-Z0-9] 匹配从 AZ或任何数字字符的任何单个字母字符。
\d{2} 匹配两个数字字符。
[A-Z0-9] 匹配从 AZ或任何数字字符的任何单个字母字符。
- 匹配连字符。
\d{3} 完全匹配三个数字字符。
(-\d{3}){2} 查找后跟三个数字字符的连字符,并匹配此模式的两个匹配项。
[A-Z0-9] 匹配从 AZ或任何数字字符的任何单个字母字符。
$ 在字符串末尾结束匹配。

调用 IsMatch(String, String, RegexOptions, TimeSpan) 方法时 options 参数设置为 RegexOptions.IgnoreCase 等效于定义以下正则表达式:

[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]

有关比较,请参阅 IsMatch(String, String) 方法的示例。

注解

IsMatch 方法通常用于验证字符串或确保字符串符合特定模式,而无需检索该字符串以供后续操作。 如果要确定一个或多个字符串是否与正则表达式模式匹配,然后检索它们以供后续操作,请调用 MatchMatches 方法。

静态 IsMatch(String, String, RegexOptions, TimeSpan) 方法等效于使用 pattern 指定的正则表达式模式和 options 指定的正则表达式选项和调用 IsMatch(String) 实例方法指定的正则表达式模式构造 Regex 对象。 此正则表达式模式缓存供正则表达式引擎快速检索。

pattern 参数由正则表达式语言元素组成,这些元素以符号方式描述要匹配的字符串。 有关正则表达式的详细信息,请参阅 .NET 正则表达式正则表达式语言 - 快速参考

matchTimeout 参数指定模式匹配方法在超时之前应尝试查找匹配的时间。设置超时间隔可防止依赖过度回溯的正则表达式在处理包含接近匹配项的输入时停止响应。 有关详细信息,请参阅 正则表达式的最佳做法回溯。 如果未在该时间间隔中找到匹配项,该方法将引发 RegexMatchTimeoutException 异常。 matchTimeout 替代为方法在其中执行的应用程序域定义的任何默认超时值。

调用方说明

建议将 matchTimeout 参数设置为适当的值,例如两秒。 如果通过指定 InfiniteMatchTimeout来禁用超时,则正则表达式引擎提供略微更好的性能。 但是,应仅在以下情况下禁用超时:

  • 当正则表达式处理的输入派生自已知且受信任的源或包含静态文本时。 这不包括用户动态输入的文本。

  • 当正则表达式模式经过全面测试以确保它有效地处理匹配项、非匹配项和接近匹配项时。

  • 当正则表达式模式不包含任何已知在处理接近匹配时导致过度回溯的语言元素。

另请参阅

适用于

IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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

例外

发生正则表达式分析错误。

inputpatternnull

options 不是有效的 RegexOptions 值。

发生超时。 有关超时的详细信息,请参阅“备注”部分。

示例

下面的示例演示如何使用 IsMatch(String, String) 方法来确定字符串是否为有效的部件号。 正则表达式假定部件号具有由连字符分隔的三组字符的特定格式。 第一个集包含四个字符,必须包含字母数字字符,后跟两个数字字符,后跟字母数字字符。 第二个集(由三个字符组成)必须是数字。 第三组由四个字符组成,必须具有三个数字字符,后跟字母数字字符。

string[] partNumbers = [ "1298-673-4192", "A08Z-931-468a",
                      "_A90-123-129X", "12345-KKA-1230",
                      "0919-2893-1256" ];
string pattern = @"^[A-Z0-9]\d{2}[A-Z0-9](-\d{3}){2}[A-Z0-9]$";
foreach (string partNumber in partNumbers)
    Console.WriteLine("{0} {1} a valid part number.",
                      partNumber,
                      Regex.IsMatch(partNumber, pattern, RegexOptions.IgnoreCase) ? "is" : "is not");

// The example displays the following output:
//       1298-673-4192 is a valid part number.
//       A08Z-931-468a is a valid part number.
//       _A90-123-129X is not a valid part number.
//       12345-KKA-1230 is not a valid part number.
//       0919-2893-1256 is not a valid part number.
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim partNumbers() As String = { "1298-673-4192", "A08Z-931-468a", _
                                      "_A90-123-129X", "12345-KKA-1230", _
                                      "0919-2893-1256" }
      Dim pattern As String = "^[A-Z0-9]\d{2}[A-Z0-9](-\d{3}){2}[A-Z0-9]$"
      For Each partNumber As String In partNumbers
         Console.WriteLine("{0} {1} a valid part number.", _
                           partNumber, _
                           IIF(Regex.IsMatch(partNumber, pattern, RegexOptions.IgnoreCase), _
                               "is", "is not"))
      Next
   End Sub
End Module
' The example displays the following output:
'       1298-673-4192 is a valid part number.
'       A08Z-931-468a is a valid part number.
'       _A90-123-129X is not a valid part number.
'       12345-KKA-1230 is not a valid part number.
'       0919-2893-1256 is not a valid part number.

正则表达式模式为:

^[A-Z0-9]\d{2}[A-Z0-9](-\d{3}){2}[A-Z0-9]$

下表显示了如何解释正则表达式模式。

模式 描述
^ 在字符串开头开始匹配。
[A-Z0-9] 匹配从 AZ或任何数字字符的任何单个字母字符。
\d{2} 匹配两个数字字符。
[A-Z0-9] 匹配从 AZ或任何数字字符的任何单个字母字符。
- 匹配连字符。
\d{3} 完全匹配三个数字字符。
(-\d{3}){2} 查找后跟三个数字字符的连字符,并匹配此模式的两个匹配项。
[A-Z0-9] 匹配从 AZ或任何数字字符的任何单个字母字符。
$ 在字符串末尾结束匹配。

调用 IsMatch(String, String, RegexOptions) 方法时 options 参数设置为 RegexOptions.IgnoreCase 等效于定义以下正则表达式:

[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]

有关比较,请参阅 IsMatch(String, String) 方法的示例。

注解

IsMatch 方法通常用于验证字符串或确保字符串符合特定模式,而无需检索该字符串以供后续操作。 如果要确定一个或多个字符串是否与正则表达式模式匹配,然后检索它们以供后续操作,请调用 MatchMatches 方法。

静态 IsMatch(String, String, RegexOptions) 方法等效于使用 pattern 指定的正则表达式模式和 options 指定的正则表达式选项和调用 IsMatch(String) 实例方法指定的正则表达式模式构造 Regex 对象。 此正则表达式模式缓存供正则表达式引擎快速检索。

pattern 参数由正则表达式语言元素组成,这些元素以符号方式描述要匹配的字符串。 有关正则表达式的详细信息,请参阅 .NET 正则表达式正则表达式语言 - 快速参考

如果匹配操作的执行时间超过为调用该方法的应用程序域指定的超时间隔,则会引发 RegexMatchTimeoutException 异常。 如果在应用程序域的属性中未定义超时,或者超时值 Regex.InfiniteMatchTimeout,则不会引发异常。

调用方说明

此方法在一个时间间隔后超时,该值等于调用它的应用程序域的默认超时值。 如果未为应用程序域定义超时值,则使用阻止方法超时的值 InfiniteMatchTimeout。 用于验证模式匹配的推荐静态方法 IsMatch(String, String, RegexOptions, TimeSpan),这使你可以设置超时间隔。

另请参阅

适用于

IsMatch(ReadOnlySpan<Char>, String, RegexOptions)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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

例外

发生正则表达式分析错误。

inputpatternnull

发生超时。 有关超时的详细信息,请参阅“备注”部分。

示例

下面的示例演示如何使用 IsMatch(String, String) 方法来确定字符串是否为有效的部件号。 正则表达式假定部件号具有由连字符分隔的三组字符的特定格式。 第一个集包含四个字符,必须包含字母数字字符,后跟两个数字字符,后跟字母数字字符。 第二个集(由三个字符组成)必须是数字。 第三组由四个字符组成,必须具有三个数字字符,后跟字母数字字符。

string[] partNumbers = [ "1298-673-4192", "A08Z-931-468A",
                      "_A90-123-129X", "12345-KKA-1230",
                      "0919-2893-1256" ];
string pattern = @"^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$";
foreach (string partNumber in partNumbers)
    Console.WriteLine($"{partNumber} {(Regex.IsMatch(partNumber, pattern) ? "is" : "is not")} " +
        $"a valid part number.");

// The example displays the following output:
//       1298-673-4192 is a valid part number.
//       A08Z-931-468A is a valid part number.
//       _A90-123-129X is not a valid part number.
//       12345-KKA-1230 is not a valid part number.
//       0919-2893-1256 is not a valid part number.
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim partNumbers() As String = { "1298-673-4192", "A08Z-931-468A", _
                                      "_A90-123-129X", "12345-KKA-1230", _
                                      "0919-2893-1256" }
      Dim pattern As String = "^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$"
      For Each partNumber As String In partNumbers
         Console.WriteLine("{0} {1} a valid part number.", _
                           partNumber, _
                           IIF(Regex.IsMatch(partNumber, pattern), "is", "is not"))
      Next
   End Sub
End Module
' The example displays the following output:
'       1298-673-4192 is a valid part number.
'       A08Z-931-468A is a valid part number.
'       _A90-123-129X is not a valid part number.
'       12345-KKA-1230 is not a valid part number.
'       0919-2893-1256 is not a valid part number.

正则表达式模式为:

^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$

下表显示了如何解释正则表达式模式。

模式 描述
^ 在行的开头开始匹配。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
\d{2} 匹配两个数字字符。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
- 匹配连字符。
\d{3} 完全匹配三个数字字符。
(-\d{3}){2} 查找后跟三个数字字符的连字符,并匹配此模式的两个匹配项。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
$ 在行尾结束匹配。

注解

IsMatch 方法通常用于验证字符串或确保字符串符合特定模式,而无需检索该字符串以供后续操作。 如果要确定一个或多个字符串是否与正则表达式模式匹配,然后检索它们以供后续操作,请调用 MatchMatches 方法。

静态 IsMatch(String, String) 方法等效于使用 pattern 指定的正则表达式模式构造 Regex 对象并调用 IsMatch(String) 实例方法。 此正则表达式模式缓存供正则表达式引擎快速检索。

pattern 参数由正则表达式语言元素组成,这些元素以符号方式描述要匹配的字符串。 有关正则表达式的详细信息,请参阅 .NET 正则表达式正则表达式语言 - 快速参考

如果匹配操作的执行时间超过为调用该方法的应用程序域指定的超时间隔,则会引发 RegexMatchTimeoutException 异常。 如果在应用程序域的属性中未定义超时,或者超时值 Regex.InfiniteMatchTimeout,则不会引发异常。

调用方说明

此方法在一个等于调用该方法的应用程序域的默认超时值的间隔后超时。 如果未为应用程序域定义超时值,则使用阻止方法超时的值 InfiniteMatchTimeout。 用于验证模式匹配的推荐静态方法 IsMatch(String, String, RegexOptions, TimeSpan),这使你可以设置超时间隔。

另请参阅

适用于

IsMatch(ReadOnlySpan<Char>, Int32)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
Regex.Match.cs

指示正则表达式构造函数中指定的正则表达式是否在指定的输入范围中找到匹配项。

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

从零开始搜索的字符位置。

返回

如果正则表达式找到匹配项,则 true;否则,false

例外

发生超时。

适用于

IsMatch(ReadOnlySpan<Char>, String)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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 小于零或大于 input的长度。

发生超时。 有关超时的详细信息,请参阅“备注”部分。

示例

下面的示例演示如何使用 IsMatch(String, Int32) 方法来确定字符串是否为有效的部件号。 它搜索一个在字符串中遵循冒号(:)字符)的部件号。 IndexOf(Char) 方法用于确定冒号字符的位置,然后传递给 IsMatch(String, Int32) 方法。 正则表达式假定部件号具有由连字符分隔的三组字符的特定格式。 第一个集包含四个字符,必须包含字母数字字符,后跟两个数字字符,后跟字母数字字符。 第二个集(由三个字符组成)必须是数字。 第三组由四个字符组成,必须具有三个数字字符,后跟字母数字字符。

string[] partNumbers = [ "Part Number: 1298-673-4192", "Part No: A08Z-931-468A",
                      "_A90-123-129X", "123K-000-1230",
                      "SKU: 0919-2893-1256" ];
Regex rgx = MyRegex();
foreach (string partNumber in partNumbers)
{
    int start = partNumber.IndexOf(':');
    if (start >= 0)
    {
        Console.WriteLine($"{partNumber} {(rgx.IsMatch(partNumber, start) ? "is" : "is not")} a valid part number.");
    }
    else
    {
        Console.WriteLine("Cannot find starting position in {0}.", partNumber);
    }
}

// The example displays the following output:
//       Part Number: 1298-673-4192 is a valid part number.
//       Part No: A08Z-931-468A is a valid part number.
//       Cannot find starting position in _A90-123-129X.
//       Cannot find starting position in 123K-000-1230.
//       SKU: 0919-2893-1256 is not a valid part number.
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim partNumbers() As String = { "Part Number: 1298-673-4192", "Part No: A08Z-931-468A", _
                                      "_A90-123-129X", "123K-000-1230", _
                                      "SKU: 0919-2893-1256" }
      Dim rgx As New Regex("[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$")
      For Each partNumber As String In partNumbers
         Dim start As Integer = partNumber.IndexOf(":"c)
         If start >= 0 Then 
            Console.WriteLine("{0} {1} a valid part number.", _
                              partNumber, _
                              IIF(rgx.IsMatch(partNumber, start), "is", "is not"))
         Else
            Console.WriteLine("Cannot find starting position in {0}.", partNumber)
         End If                              
      Next
   End Sub
End Module
' The example displays the following output:
'       Part Number: 1298-673-4192 is a valid part number.
'       Part No: A08Z-931-468A is a valid part number.
'       Cannot find starting position in _A90-123-129X.
'       Cannot find starting position in 123K-000-1230.
'       SKU: 0919-2893-1256 is not a valid part number.

正则表达式模式为:

[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$

下表显示了如何解释正则表达式模式。

模式 描述
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
\d{2} 匹配两个数字字符。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
- 匹配连字符。
\d{3} 完全匹配三个数字字符。
(-\d{3}){2} 查找后跟三个数字字符的连字符,并匹配此模式的两个匹配项。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
$ 在行尾结束匹配。

注解

IsMatch 方法通常用于验证字符串或确保字符串符合特定模式,而无需检索该字符串以供后续操作。 如果要确定一个或多个字符串是否与正则表达式模式匹配,然后检索它们以供后续操作,请调用 MatchMatches 方法。

有关 startat的更多详细信息,请参阅 Match(String, Int32)的“备注”部分。

如果匹配操作的执行时间超过 Regex.Regex(String, RegexOptions, TimeSpan) 构造函数指定的超时间隔,则会引发 RegexMatchTimeoutException 异常。 如果在调用构造函数时未设置超时间隔,则如果操作超出了为在其中创建 Regex 对象的应用程序域建立的任何超时值,则会引发异常。 如果在 Regex 构造函数调用或应用程序域的属性中未定义超时,或者超时值 Regex.InfiniteMatchTimeout,则不会引发异常。

另请参阅

适用于

IsMatch(String)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
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) 方法来确定字符串是否为有效的部件号。 正则表达式假定部件号具有由连字符分隔的三组字符的特定格式。 第一个集包含四个字符,必须包含字母数字字符,后跟两个数字字符,后跟字母数字字符。 第二个集(由三个字符组成)必须是数字。 第三组由四个字符组成,必须具有三个数字字符,后跟字母数字字符。

string[] partNumbers = [ "1298-673-4192", "A08Z-931-468A",
                      "_A90-123-129X", "12345-KKA-1230",
                      "0919-2893-1256" ];
Regex rgx = new Regex(@"^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$");
foreach (string partNumber in partNumbers)
    Console.WriteLine($"{partNumber} {(rgx.IsMatch(partNumber) ? "is" : "is not")} a valid part number.");

// The example displays the following output:
//       1298-673-4192 is a valid part number.
//       A08Z-931-468A is a valid part number.
//       _A90-123-129X is not a valid part number.
//       12345-KKA-1230 is not a valid part number.
//       0919-2893-1256 is not a valid part number.
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim partNumbers() As String = { "1298-673-4192", "A08Z-931-468A", _
                                      "_A90-123-129X", "12345-KKA-1230", _
                                      "0919-2893-1256" }
      Dim rgx As New Regex("^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$")
      For Each partNumber As String In partNumbers
         Console.WriteLine("{0} {1} a valid part number.", _
                           partNumber, _
                           IIF(rgx.IsMatch(partNumber), "is", "is not"))
      Next
   End Sub
End Module
' The example displays the following output:
'       1298-673-4192 is a valid part number.
'       A08Z-931-468A is a valid part number.
'       _A90-123-129X is not a valid part number.
'       12345-KKA-1230 is not a valid part number.
'       0919-2893-1256 is not a valid part number.

正则表达式模式为:

^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$

下表显示了如何解释正则表达式模式。

模式 描述
^ 在行的开头开始匹配。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
\d{2} 匹配两个数字字符。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
- 匹配连字符。
\d{3} 完全匹配三个数字字符。
(-\d{3}){2} 查找后跟三个数字字符的连字符,并匹配此模式的两个匹配项。
[a-zA-Z0-9] 匹配单个字母字符(通过 za 或通过 ZA)或数字字符。
$ 在行尾结束匹配。

注解

IsMatch 方法通常用于验证字符串或确保字符串符合特定模式,而无需检索该字符串以供后续操作。 如果要确定一个或多个字符串是否与正则表达式模式匹配,然后检索它们以供后续操作,请调用 MatchMatches 方法。

如果匹配操作的执行时间超过 Regex.Regex(String, RegexOptions, TimeSpan) 构造函数指定的超时间隔,则会引发 RegexMatchTimeoutException 异常。 如果在调用构造函数时未设置超时间隔,则如果操作超出了为在其中创建 Regex 对象的应用程序域建立的任何超时值,则会引发异常。 如果在 Regex 构造函数调用或应用程序域的属性中未定义超时,或者超时值 Regex.InfiniteMatchTimeout,则不会引发异常。

另请参阅

适用于

IsMatch(ReadOnlySpan<Char>)

Source:
Regex.Match.cs
Source:
Regex.Match.cs
Source:
Regex.Match.cs

指示正则表达式构造函数中指定的正则表达式是否在指定的输入范围中找到匹配项。

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

例外

发生超时。

适用于