GroupCollection.Item[] プロパティ

リファレンス

定義

名前空間:: System.Text.RegularExpressions

アセンブリ:: System.Text.RegularExpressions.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

整数インデックスまたは文字列インデックスによってコレクションの単一のメンバーにアクセスできるようになります。

オーバーロード

Item[Int32]	整数インデックスによってコレクションのメンバーにアクセスできるようにします。
Item[String]	文字列インデックスによってコレクションのメンバーにアクセスできるようにします。

Item[Int32]

Source:: GroupCollection.cs

Source:: GroupCollection.cs

Source:: GroupCollection.cs

整数インデックスによってコレクションのメンバーにアクセスできるようにします。

public:
 property System::Text::RegularExpressions::Group ^ default[int] { System::Text::RegularExpressions::Group ^ get(int groupnum); };

public System.Text.RegularExpressions.Group this[int groupnum] { get; }

member this.Item(int) : System.Text.RegularExpressions.Group

Default Public ReadOnly Property Item(groupnum As Integer) As Group

パラメーター

groupnum: Int32

取得するコレクションメンバーの 0 から始まるインデックス。

プロパティ値

Group

groupnum で指定されたコレクションのメンバー。

実装

Item[Int32]

例

次の例では、2 つの番号付きグループで構成される正規表現を定義します。最初のグループは、1 つ以上の連続した数字をキャプチャします。 2 番目のグループは 1 文字に一致します。正規表現エンジンは最初のグループの 0 回または 1 回の出現を検索するため、正規表現の一致が成功した場合でも、必ずしも一致が見つかるとは限りません。次に、一致しないグループ、一致するグループ、および正規表現で定義されていないグループを取得するためにプロパティを使用した場合 Item[Int32] の結果を示します。この例では、次の表に示すように解釈される正規表現パターン (\d+)*(\w)\2を定義します。

パターン	説明
`(\d+)*`	10 進数の 1 つ以上の出現箇所と一致します。これが最初のキャプチャグループです。このパターンを 0 回または 1 回一致させます。
`(\w)`	これが 2 番目のキャプチャグループです。
`\k`	2 番目のキャプチャグループによってキャプチャされた文字列と一致します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"(\d+)*(\w)\2";
      string input = "AA";
      Match match = Regex.Match(input, pattern);
      
      // Get the first named group.
      Group group1 = match.Groups[1];
      Console.WriteLine("Group 1 value: {0}", group1.Success ? group1.Value : "Empty");
      
      // Get the second named group.
      Group group2 = match.Groups[2];
      Console.WriteLine("Group 2 value: {0}", group2.Success ? group2.Value : "Empty");
      
      // Get a non-existent group.
      Group group3 = match.Groups[3];
      Console.WriteLine("Group 3 value: {0}", group3.Success ? group3.Value : "Empty");
   }
}
// The example displays the following output:
//       Group 1 value: Empty
//       Group 2 value: A
//       Group 3 value: Empty

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(\d+)*(\w)\2"
      Dim input As String = "AA"
      Dim match As Match = Regex.Match(input, pattern)
      
      ' Get the first named group.
      Dim group1 As Group = match.Groups.Item(1)
      Console.WriteLine("Group 1 value: {0}", If(group1.Success, group1.Value, "Empty"))
      
      ' Get the second named group.
      Dim group2 As Group = match.Groups.Item(2)
      Console.WriteLine("Group 2 value: {0}", If(group2.Success, group2.Value, "Empty"))
      
      ' Get a non-existent group.
      Dim group3 As Group = match.Groups.Item(3)
      Console.WriteLine("Group 3 value: {0}", If(group3.Success, group3.Value, "Empty"))
   End Sub
End Module
' The example displays the following output:
'       Group 1 value: Empty
'       Group 2 value: A
'       Group 3 value: Empty

注釈

プロパティは Item[Int32] 、クラスのインデックス (C#) または既定の GroupCollection プロパティ (Visual Basic の場合) です。これにより、C# のステートメントまたは Visual Basic のステートメントを foreach 使用して、コレクションのメンバーを For Each 列挙できます。

このプロパティを使用して、個々のキャプチャされたグループをインデックス番号で取得することもできます。インスタンス Regex.GetGroupNumbers メソッドを呼び出すことで、正規表現内のすべてのキャプチャグループの数を含む配列を取得できます。インスタンス Regex.GroupNumberFromName メソッドを呼び出して、名前付きキャプチャグループを番号にマップすることもできます。

プロパティの値を取得することで、コレクション内の項目の数を Count 確認できます。パラメーターの有効な値の範囲は groupnum 、0 からコレクション内の項目数より 1 未満です。

プロパティによって返されるオブジェクトには GroupCollection 、常に Match.Groups 少なくとも 1 つのメンバーが含まれます。正規表現エンジンで特定の入力文字列内の一致が見つからない場合、コレクション内の単一Groupオブジェクトのプロパティはにfalse設定され、そのGroup.Valueプロパティは Group.Success にString.Empty設定されます。

がコレクションのメンバーのインデックスではない場合groupnum、またはが入力文字列内で一致していないキャプチャグループのインデックスである場合groupnum、メソッドはプロパティがでありfalse、プロパティがであるString.EmptyオブジェクトGroup.SuccessをGroup.Value返Groupします。

こちらもご覧ください

正規表現での構成体のグループ化

適用対象

Item[String]

Source:: GroupCollection.cs

Source:: GroupCollection.cs

Source:: GroupCollection.cs

文字列インデックスによってコレクションのメンバーにアクセスできるようにします。

public:
 property System::Text::RegularExpressions::Group ^ default[System::String ^] { System::Text::RegularExpressions::Group ^ get(System::String ^ groupname); };

public System.Text.RegularExpressions.Group this[string groupname] { get; }

member this.Item(string) : System.Text.RegularExpressions.Group

Default Public ReadOnly Property Item(groupname As String) As Group

パラメーター

groupname: String

キャプチャグループの名前。

プロパティ値

Group

groupname で指定されたコレクションのメンバー。

実装

Item[TKey]

例

次の例では、2 つの名前付きグループで構成される正規表現を定義します。最初のグループであるは、 numbers1 つ以上の連続した数字をキャプチャします。 2 番目のグループであるは、 letter1 文字に一致します。正規表現エンジンは、グループによって定義されたパターンの 0 回または 1 回の出現を numbers 検索するため、 numbers 一致が成功した場合でも、グループが常に存在するとは限りません。次に、一致しないグループ、一致するグループ、および正規表現で定義されていないグループを取得するためにプロパティを使用した場合 Item[String] の結果を示します。この例では、次の表に示すように解釈される正規表現パターン (?<numbers>\d+)*(?<letter>\w)\k<letter>を定義します。

パターン	説明
`(?<numbers>\d+)*`	10 進数の 1 つ以上の出現箇所と一致します。このグループにキャプチャグループという `numbers` 名前を付けます。このパターンを 0 回または 1 回一致させます。
`(?<letter>\w)`	1 つの単語文字と一致します。このグループにキャプチャグループという `letter` 名前を付けます。
`\k<letter>`	キャプチャグループによってキャプチャされた文字列と `letter` 一致します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"(?<numbers>\d+)*(?<letter>\w)\k<letter>";
      string input = "AA";
      Match match = Regex.Match(input, pattern);
      
      // Get the first named group.
      Group group1 = match.Groups["numbers"];
      Console.WriteLine("Group 'numbers' value: {0}", group1.Success ? group1.Value : "Empty");
      
      // Get the second named group.
      Group group2 = match.Groups["letter"];
      Console.WriteLine("Group 'letter' value: {0}", group2.Success ? group2.Value : "Empty");
      
      // Get a non-existent group.
      Group group3 = match.Groups["none"];
      Console.WriteLine("Group 'none' value: {0}", group3.Success ? group3.Value : "Empty");
   }
}
// The example displays the following output:
//       Group 'numbers' value: Empty
//       Group 'letter' value: A
//       Group 'none' value: Empty

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(?<numbers>\d+)*(?<letter>\w)\k<letter>"
      Dim input As String = "AA"
      Dim match As Match = Regex.Match(input, pattern)
      
      ' Get the first named group.
      Dim group1 As Group = match.Groups.Item("numbers")
      Console.WriteLine("Group 'numbers' value: {0}", If(group1.Success, group1.Value, "Empty"))
      
      ' Get the second named group.
      Dim group2 As Group = match.Groups.Item("letter")
      Console.WriteLine("Group 'letter' value: {0}", If(group2.Success, group2.Value, "Empty"))
      
      ' Get a non-existent group.
      Dim group3 As Group = match.Groups.Item("none")
      Console.WriteLine("Group 'none' value: {0}", If(group3.Success, group3.Value, "Empty"))
   End Sub
End Module
' The example displays the following output:
'       Group 'numbers' value: Empty
'       Group 'letter' value: A
'       Group 'none' value: Empty

注釈

groupNameは、正規表現の name 要素によって定義されるキャプチャグループの名前>)、またはグループ化コンストラクトによって(?<定義されるキャプチャグループの番号の文字列表現のいずれかになります。正規表現のグループの詳細については、「グループ化コンストラクト」を参照してください。

メソッドを呼び出すことで、オブジェクト内のすべてのキャプチャされたグループの Regex 名前を Regex.GetGroupNames 取得できます。また、メソッドを呼び出して、正規表現内のキャプチャグループの数を名前に Regex.GroupNameFromNumber マップすることもできます。その後、配列の個々の名前をプロパティに渡して Item[String] 、キャプチャされた文字列を取得できます。

groupnameがコレクション内のキャプチャグループの名前ではない場合、またはが入力文字列で一致していないキャプチャグループの名前である場合groupname、メソッドはプロパティが false で、プロパティがであるString.EmptyオブジェクトGroup.SuccessをGroup.Value返Groupします。

こちらもご覧ください

正規表現での構成体のグループ化

適用対象

GroupCollection.Item[] プロパティ

定義

オーバーロード

Item[Int32]

パラメーター

プロパティ値

実装

例

注釈

こちらもご覧ください

適用対象

Item[String]

パラメーター

プロパティ値

実装

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース