msdnのRegex.Matchesメソッドの説明を翻訳した

public MatchCollection Matches(
        string input
)

• input

  Type: System.String

  一致するものを検索する文字列。

• 戻り値

  Type: System.Text.RegularExpressions.MatchCollection

  検索によって見つかった、Matchオブジェクトのコレクション。一致が見つからない場合、メソッドは、空のコレクション・オブジェクトを返します。

Matches(String)メソッドは、一つの一致の代わりに、入力文字列で見つかるすべての一致について、情報を返すこと以外は、Match(String)メソッドに似ています。 それは、次のコードと同等です。：

Match match = regex.Match(input);
while (match.Success) {
      // Handle match here…
      // 一致をここで処理します...

      match = match.NextMatch();
}

コレクションは、一致だけが含まれており、そして、最初の不一致で終了します。

Matches(String)メソッドが、どれを検索するかを示す正規表現パターンは、１つのRegexクラスのコンストラクタへの呼び出しによって定義されています。 正規表現パターンを組み立てることができる要素の詳細については、正規表現言語 ― クイック・リファレンス ― を参照してください。

Matchesメソッドは、返されたMatchCollectionオブジェクトを埋め込むために、遅延評価を使用します。 MatchCollection.CountやMatchCollection.CopyToが、すぐに、コレクションに取り込まれるように、このコレクションのメンバーを呼び出します。 遅延評価を利用するために、あなたは、C#のforeachとVisual BasicのForEach…Nextのような、言語要素を使用してコレクションを繰り返す必要があります。

その遅延評価のため、Matches(String)メソッドを呼び出すと、RegexMatchTimeoutException例外が投げられません。 しかしながら、操作が、MatchTimeoutプロパティが、Regex.InfiniteMatchTimeoutでない場合、 このメソッドで返されるMatchCollectionオブジェクト上で実行されたとき、例外が、投げられます。 そして、一致する操作は、タイムアウト間隔を超過します。

次の例は、文が「es」で終わるいずれかの単語を認識するために、Matches(String)メソッドを使用します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\b\w+es\b";
      Regex rgx = new Regex(pattern);
      string sentence = "Who writes these notes?";

      foreach (Match match in rgx.Matches(sentence))
         Console.WriteLine("Found '{0}' at position {1}", 
                           match.Value, match.Index);
   }
}
// The example displays the following output:
//       Found 'writes' at position 4
//       Found 'notes' at position 17

正規表現パターン\b\w+es\bは、次の表で示すように定義されます。

public static MatchCollection Matches(
        string input,
        string pattern
)

パラメーター

Matches(String, String)メソッドは、それが、入力文字列で見つかるすべての一致について、一つの一致の代わりに、情報を返すこと以外は、Match(String, String)メソッドに似ています。それは、次のコードと同等です。：

Match match = Regex.Match(input, pattern);
while (match.Success) {
      // Handle match here…
      // 一致をここで処理します...

      match = match.NextMatch();
}  

static Matchesメソッドは、指定された正規表現パターンで、Regexオブジェクトを構築することと同じです。そして、インスタンスメソッドの一致を呼び出します。

パターン・パラメータは、一致するための文字列を象徴的に説明する正規表現言語要素から構成されています。正規表現の詳細については、.NET Frameworkの正規表現と正規表現言語 ― クイック・リファレンス ― を参照してください。

Matchesメソッドは、返されたMatchCollectionオブジェクトを埋め込むために、遅延評価を使用します。このコレクションのメンバーを呼び出します。MatchCollection.CountやMatchCollection.CopyToが、すぐに、コレクションに取り込まれるように、遅延評価を利用するために、あなたは、C#のforeachとVisual BasicのForEach…Nextのような、言語要素を使用して、コレクションを繰り返す必要があります。

その遅延評価のため、Matches(String, String)メソッドを呼び出すと、RegexMatchTimeoutException例外が投げられません。しかしながら、操作が、このメソッドで返されるMatchCollectionオブジェクト上で実行されたとき、例外が、投げられます。タイムアウト間隔が、現在のアプリケーションドメインの "REGEX_DEFAULT_MATCH_TIMEOUT"プロパティによって定義されている場合、そして、一致する操作は、タイムアウト間隔を超過します。

このメソッドは、メソッドがタイムアウトするのを防ぐ値Regex.InfiniteMatchTimeoutが使用されるタイムアウト値が、アプリケーション・ドメインに定義されていない場合、呼び出されるアプリケーション・ドメインの既定のタイムアウト値と等価な一定間隔の後、タイムアウトします。複数のパターン一致を取得するために推奨された静的メソッドは、あなたが、タイムアウト間隔を指定することができるRegex.Matches(String, String, RegexOptions, TimeSpan)です。

次の例は、「es」で終わる文の単語を特定するために、Matches(String, String)メソッドを使います。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\b\w+es\b";
      string sentence = "Who writes these notes?";

      foreach (Match match in Regex.Matches(sentence, pattern))
         Console.WriteLine("Found '{0}' at position {1}", 
                           match.Value, match.Index);
   }
}
// The example displays the following output:
//       Found 'writes' at position 4
//       Found 'notes' at position 17

正規表現パターン\b\w+es\bは、次の表で示すように定義されます。