Match.Groups プロパティ

public:
 virtual property System::Text::RegularExpressions::GroupCollection ^ Groups { System::Text::RegularExpressions::GroupCollection ^ get(); };

public virtual System.Text.RegularExpressions.GroupCollection Groups { get; }

member this.Groups : System.Text.RegularExpressions.GroupCollection

Public Overridable ReadOnly Property Groups As GroupCollection

プロパティ値

パターンに一致する文字グループ。

注釈

正規表現パターンには、正規表現パターンの一部をかっこで囲んで定義される部分式を含めることができます。 このような部分式はすべてグループを形成します。 Groups プロパティは、これらの部分式の一致に関する情報へのアクセスを提供します。 たとえば、北米の電話番号と一致する正規表現パターン (\d{3})-(\d{3}-\d{4})には、2 つの部分式があります。 1 つ目は、電話番号の最初の 3 桁を構成するエリア コードで構成されます。 このグループは、かっこの最初のセット ( (\d{3})) によってキャプチャされます。 2 番目の番号は、電話番号の最後の 7 桁を構成する個々の電話番号で構成されます。 このグループは、かっこの 2 番目のセット ( (\d{3}-\d{4})) によってキャプチャされます。

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

コレクションに複数のメンバーがある場合、コレクション内の最初の項目は、 Match オブジェクト (一致全体) と同じです。 正規表現にキャプチャ グループが含まれている場合、後続の各メンバーはキャプチャされたグループを表します。 グループには、整数インデックスまたは名前付きグループの名前でアクセスできます。