Regex.IsMatch 方法正则表达式在输入字符串中是否找到匹配项C#

要搜索匹配项的字符串。

如果正则表达式找到匹配项，则为 true；否则为 false。

异常

input 为 null。

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

示例

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

C#复制

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      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("{0} {1} a valid part number.", 
                           partNumber, 
                           rgx.IsMatch(partNumber) ? "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.

正则表达式模式为：

复制

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

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

模式	说明
`^`	从行的开头开始匹配。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`\d{2}`	匹配两个数字字符。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`-`	匹配连字符。
`\d{3}`	正好匹配三个数字字符。
`(-\d{3}){2}`	查找后跟三个数字字符的连字符，并匹配此模式的两个匹配项。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`$`	在行的末尾结束匹配。

注解

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

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

另请参阅

正则表达式语言元素

IsMatch(String, Int32)

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

C#复制

public bool IsMatch (string input, int startat);

参数

input

要搜索匹配项的字符串。

startat

Int32

开始搜索的字符位置。

如果正则表达式找到匹配项，则为 true；否则为 false。

异常

ArgumentOutOfRangeException

input 为 null。

startat 小于零或大于 input 的长度。

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

示例

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

C#复制

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string[] partNumbers= { "Part Number: 1298-673-4192", "Part No: A08Z-931-468A", 
                              "_A90-123-129X", "123K-000-1230", 
                              "SKU: 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)
      {
         int start = partNumber.IndexOf(':');
         if (start >= 0)
         {
            Console.WriteLine("{0} {1} a valid part number.", 
                              partNumber, 
                              rgx.IsMatch(partNumber, start) ? "is" : "is not");
         }
         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.

正则表达式模式为：

复制

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

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

模式	说明
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`\d{2}`	匹配两个数字字符。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`-`	匹配连字符。
`\d{3}`	正好匹配三个数字字符。
`(-\d{3}){2}`	查找后跟三个数字字符的连字符，并匹配此模式的两个匹配项。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`$`	在行的末尾结束匹配。

注解

另请参阅

正则表达式语言元素

IsMatch(String, String)

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

C#复制

public static bool IsMatch (string input, string pattern);

参数

input

要搜索匹配项的字符串。

pattern

要匹配的正则表达式模式。

如果正则表达式找到匹配项，则为 true；否则为 false。

异常

ArgumentException

出现正则表达式分析错误。

input 或 pattern 为 null。

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

示例

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

C#复制

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      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("{0} {1} a valid part number.", 
                           partNumber, 
                           Regex.IsMatch(partNumber, pattern) ? "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.

正则表达式模式为：

复制

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

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

模式	说明
`^`	从行的开头开始匹配。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`\d{2}`	匹配两个数字字符。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`-`	匹配连字符。
`\d{3}`	正好匹配三个数字字符。
`(-\d{3}){2}`	查找后跟三个数字字符的连字符，并匹配此模式的两个匹配项。
`[a-zA-Z0-9]`	匹配单个字母字符（`a` 到 `z` 或 `A` 到 `Z`）或数字字符。
`$`	在行的末尾结束匹配。

注解

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

pattern 参数包含符号描述要匹配的字符串的正则表达式语言元素。有关正则表达式的详细信息，请参阅.NET Framework 正则表达式和正则表达式语言-快速参考。

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

调用方说明

此方法在与调用方法的应用程序域的默认超时值相等的时间间隔后超时。如果尚未为应用程序域定义超时值，则将使用值 InfiniteMatchTimeout，这会阻止方法超时。用于验证模式匹配的建议静态方法是 IsMatch(String, String, RegexOptions, TimeSpan)，这允许您设置超时间隔。

另请参阅

正则表达式语言元素

IsMatch(String, String, RegexOptions)

指示所指定的正则表达式是否使用指定的匹配选项在指定的输入字符串中找到了匹配项。

C#复制

public static bool IsMatch (string input, string pattern, System.Text.RegularExpressions.RegexOptions options);

参数

input

要搜索匹配项的字符串。

pattern

要匹配的正则表达式模式。

options

RegexOptions

枚举值的一个按位组合，这些枚举值提供匹配选项。

如果正则表达式找到匹配项，则为 true；否则为 false。

异常

ArgumentException

出现正则表达式分析错误。

ArgumentOutOfRangeException

input 或 pattern 为 null。

options 不是有效的 RegexOptions 值。

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

示例

C#复制

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      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.

正则表达式模式为：

复制

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

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

模式	说明
`^`	从字符串开头开始匹配。
`[A-Z0-9]`	匹配从 `A` 到 `Z`或任意数字字符的任何单个字母字符。
`\d{2}`	匹配两个数字字符。
`[A-Z0-9]`	匹配从 `A` 到 `Z`或任意数字字符的任何单个字母字符。
`-`	匹配连字符。
`\d{3}`	正好匹配三个数字字符。
`(-\d{3}){2}`	查找后跟三个数字字符的连字符，并匹配此模式的两个匹配项。
`[A-Z0-9]`	匹配从 `A` 到 `Z`或任意数字字符的任何单个字母字符。
`$`	在字符串的结尾结束匹配。

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

复制

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

若要进行比较，请参阅 IsMatch(String, String) 方法的示例。

注解

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

调用方说明

此方法在与调用该方法的应用程序域的默认超时值相等的时间间隔后超时。如果尚未为应用程序域定义超时值，则将使用值 InfiniteMatchTimeout，这会阻止方法超时。用于验证模式匹配的建议静态方法是 IsMatch(String, String, RegexOptions, TimeSpan)，这允许您设置超时间隔。

另请参阅

正则表达式语言元素

IsMatch(String, String, RegexOptions, TimeSpan)

指示所指定的正则表达式是否使用指定的匹配选项和超时间隔在指定的输入字符串中找到了匹配项。

C#复制

public static bool IsMatch (string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

参数

input

要搜索匹配项的字符串。

pattern

要匹配的正则表达式模式。

options

RegexOptions

枚举值的一个按位组合，这些枚举值提供匹配选项。

matchTimeout

TimeSpan

超时间隔；若要指示该方法不应超时，则为 InfiniteMatchTimeout。

如果正则表达式找到匹配项，则为 true；否则为 false。

异常

ArgumentException

出现正则表达式分析错误。

ArgumentOutOfRangeException

input 或 pattern 为 null。

options 不是有效的 RegexOptions 值。

-或- matchTimeout 为负、零或大于 24 天左右。