Match クラス

定義

名前空間:
System.Text.RegularExpressions
アセンブリ:
System.dll, System.Text.RegularExpressions.dll
アセンブリ:
netstandard.dll, System.Text.RegularExpressions.dll
アセンブリ:
System.Text.RegularExpressions.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll
ソース:
Match.cs
ソース:
Match.cs
ソース:
Match.cs
ソース:
Match.cs
ソース:
Match.cs

1 つの正規表現の一致の結果を表します。

public ref class Match : System::Text::RegularExpressions::Group
public class Match : System.Text.RegularExpressions.Group
[System.Serializable]
public class Match : System.Text.RegularExpressions.Group
type Match = class
    inherit Group
[<System.Serializable>]
type Match = class
    inherit Group
Public Class Match
Inherits Group
継承
Object
Capture
Group
Match
属性
SerializableAttribute

注釈

Match クラスは不変であり、パブリック コンストラクターはありません。 Match クラスのインスタンスは、Match(String) メソッドによって返され、文字列内の最初のパターン一致を表します。 後続の一致は、Match メソッドによって返NextMatch()オブジェクトによって表されます。 さらに、0 個、1 つ以上のMatchCollection オブジェクトで構成されるMatch オブジェクトは、Matches(String) メソッドによって返されます。

Matches(String) メソッドが入力文字列内の正規表現パターンと一致しない場合は、空のMatchCollection オブジェクトが返されます。 その後、 foreach コンストラクトを使用してコレクションを反復処理できます。

Match(String) メソッドが正規表現パターンと一致しない場合は、Matchと等しいEmpty オブジェクトが返されます。 Success プロパティを使用して、一致が成功したかどうかを判断できます。

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

1 つの一致に複数のキャプチャ グループが含まれる可能性があるため、MatchにはGroupsを返すGroupCollectionプロパティがあります。 Match インスタンス自体は、コレクション内の最初のオブジェクト (一致全体を表すMatch.Groups[0]) と同じです。

プロパティ

名前 説明
Captures

キャプチャ グループが一致するすべてのキャプチャのコレクションを、最も左の一番内側の最初の順序で取得します (または、正規表現が RightToLeft オプションで変更された場合は最も右の最初の順序)。 コレクションには、0 個以上の項目を含む場合があります。

(継承元 Group)
Empty

空の一致を取得します。 失敗したすべての一致は、この空の一致を返します。
Groups

正規表現で一致するグループのコレクションを取得します。
Index

キャプチャされた部分文字列の最初の文字が見つかった元の文字列内の位置を取得します。

(継承元 Capture)
Length

キャプチャされた部分文字列の長さを取得します。

(継承元 Capture)
Name

現在のインスタンスによって表されるキャプチャ グループの名前を返します。

(継承元 Group)
Success

一致が成功したかどうかを示す値を取得します。

(継承元 Group)
Value

入力文字列からキャプチャされた部分文字列を取得します。

(継承元 Capture)
ValueSpan

入力文字列からキャプチャされたスパンを取得します。

(継承元 Capture)

メソッド

名前 説明
Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
NextMatch()

最後の一致が終了した位置 (最後に一致した文字の後の文字) から始まる、次の一致の結果を含む新しい Match オブジェクトを返します。
Result(String)

渡された置換パターンの拡張を返します。 たとえば、置換パターンが $1$2されている場合、 Result(String) は Groups[1].Value と Groups[2].Valueの連結を返します。
Synchronized(Match)

複数のスレッド間で安全に共有できる、指定されたものと同等の Match インスタンスを返します。
ToString()

Value プロパティを呼び出して、入力文字列からキャプチャされた部分文字列を取得します。

(継承元 Capture)

適用対象

こちらもご覧ください