msdnのMatchクラスの説明を翻訳した

[SerializableAttribute]
public class Match : Group

T:System.Text.RegularExpressions.Matchオブジェクトは不変であり、一般のコンストラクタを持っていません。T:System.Text.RegularExpressions.Matchクラスのインスタンスは、M:System.Text.RegularExpressions.Regex.Match(System.String)メソッドによって返され、文字列内の最初のパターン一致を表現します。後に続く一致は、M: System.Text.RegularExpressions.Match.NextMatchメソッドによって返される:System.Text.RegularExpressions.Matchオブジェクトで、表現されます。加えて、M:System.Text.RegularExpressions.Regex.Matches(System.String)メソッドによって、0、1やより多くのT:System.Text.RegularExpressions.Matchオブジェクトから構成されているT:System.Text.RegularExpressions.MatchCollectionオブジェクトが、返されます。

M:System.Text.RegularExpressions.Regex.Matches(System.String)メソッドが、入力文字列内の正規表現パターンとの一致が失敗する場合、それは、空のT:System.Text.RegularExpressions.MatchCollectionオブジェクトを返します。あなたは、続いて、コレクションを繰り返すために、C#のforeach構文やVisual BasicのFor Each構文を使用することができます。

M:System.Text.RegularExpressions.Regex.Match(System.String)メソッドが、正規表現パターンとの一致に失敗する場合、それは、P:System.Text.RegularExpressions.Match.Emptyと同じ、T:System.Text.RegularExpressions.Matchオブジェクトを返します。あなたは、一致が成功していたかどうか判断するために、P:System.Text.RegularExpressions.Group.Successプロパティを使用することができます。次の例は、図を提供します。

// Search for a pattern that is not found in the input string.
// 入力文字列内で見つからないパターンを探す
string pattern = "dog";
string input = "The cat saw the other cats playing in the back yard.";
Match match = Regex.Match(input, pattern);
if (match.Success )
   // Report position as a one-based integer.
   // 1から始まる整数で、位置を報告します。
   Console.WriteLine("'{0}' was found at position {1} in '{2}'.", 
                     match.Value, match.Index + 1, input);
else
   Console.WriteLine("The pattern '{0}' was not found in '{1}'.",
                     pattern, input);

パターンの一致が成功している場合、P:System.Text.RegularExpressions.Capture.Valueプロパティには、一致した部分文字列が含まれています。P:System.Text.RegularExpressions.Capture.Indexプロパティは、入力文字列内で、一致した部分文字列の0から始まる開始位置を示します。そして、P:System.Text.RegularExpressions.Capture.Lengthプロパティは、入力文字列で一致する部分文字列の長さを示します。

一つの一致は、複数のキャプチャ・グループを含めることができるため、T:System.Text.RegularExpressions.Matchは、T:System.Text.RegularExpressions.GroupCollectionを返すP:System.Text.RegularExpressions.Match.Groupsプロパティを持っています。T:System.Text.RegularExpressions.Matchインスタンスそれ自体は、全体の一致を示すMatch.Groups[0]（Visual BasicのMatch.Groups(0)）で、コレクションの最初のオブジェクトと同等です。あなたは、次の方法で、一致でキャプチャされたグループにアクセスすることができます。：

• あなたは、foreach (C#)やFor Each (Visual Basic)構文を用いて、T:System.Text.RegularExpressions.GroupCollectionオブジェクトのメンバーを繰り返すことができます。
• あなたは、キャプチャ・グループの番号によって、グループを取得する:System.Text.RegularExpressions.GroupCollection.Item(System.Int32) propertyを使用することができます。インスタンスM:System.Text.RegularExpressions.Regex.GetGroupNumbersメソッドを呼び出すことによって、あなたが、正規表現内に、番号を付けたグループが存在するか判断できることに注意します。
• あなたは、キャプチャ・グループという名前で、グループを取得する:System.Text.RegularExpressions.GroupCollection.Item(System.String)プロパティを使用することができます。あなたが、M:System.Text.RegularExpressions.Regex.GetGroupNamesメソッドのインスタンスを呼び出すことによって、正規表現内に、名前の付いたグループが存在するか判断できることに注意します。

次の例は、正規表現Console\.Write(Line)?を使用します。正規表現は、次のように解釈されます。：

Example 1.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "int[] values = { 1, 2, 3 };\n" +
                     "for (int ctr = values.GetLowerBound(1); ctr <= values.GetUpperBound(1); ctr++)\n" +
                     "{\n" +
                     "   Console.Write(values[ctr]);\n" +
                     "   if (ctr < values.GetUpperBound(1))\n" +
                     "      Console.Write(\", \");\n" +
                     "}\n" +
                     "Console.WriteLine();\n";   

      string pattern = @"Console\.Write(Line)?";
      MatchCollection matches = Regex.Matches(input, pattern);
      foreach (Match match in matches)
         Console.WriteLine("'{0}' found in the source code at position {1}.",  
                           match.Value, match.Index);
   }
}
// The example displays the following output:
//    'Console.Write' found in the source code at position 115.
//    'Console.Write' found in the source code at position 184.
//    'Console.WriteLine' found in the source code at position 211.

Example 2.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "int[] values = { 1, 2, 3 };\n" +
                     "for (int ctr = values.GetLowerBound(1); ctr <= values.GetUpperBound(1); ctr++)\n" +
                     "{\n" +
                     "   Console.Write(values[ctr]);\n" +
                     "   if (ctr < values.GetUpperBound(1))\n" +
                     "      Console.Write(\", \");\n" +
                     "}\n" +
                     "Console.WriteLine();\n";   
      string pattern = @"Console\.Write(Line)?";
      Match match = Regex.Match(input, pattern);
      while (match.Success)
      {
         Console.WriteLine("'{0}' found in the source code at position {1}.",  
                           match.Value, match.Index);
         match = match.NextMatch();
      }
   }
}
// The example displays the following output:
//    'Console.Write' found in the source code at position 115.
//    'Console.Write' found in the source code at position 184.
//    'Console.WriteLine' found in the source code at position 211.