MATCh

.NET Framework クラス ライブラリ リファレンス

Match クラス

1 回の正規表現検索に一致した結果を表します。

名前空間: System.Text.RegularExpressions
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class Match
    Inherits Group

Visual Basic (使用法)

Dim instance As Match

C#

[SerializableAttribute] 
public class Match : Group

C++

[SerializableAttribute] 
public ref class Match : public
 Group

J#

/** @attribute SerializableAttribute() */ 
public class Match extends Group

JScript

SerializableAttribute 
public class Match extends
 Group

解説

1 回の検索で一致した対象には複数のキャプチャ グループがかかわる場合があるため、Match には GroupCollection を返す Groups プロパティがあります。GroupCollection には各グループを返すアクセサがあります。Match は、一致した部分文字列全体に直接アクセスできるように、Group から継承します。つまり、Match インスタンス自体は Match.Groups[0] (Visual Basic の場合は Match.Groups(0)) と同等です。Match オブジェクトは変更不可で、パブリック コンストラクタはありません。

継承階層

System.Object
   System.Text.RegularExpressions.Capture
     System.Text.RegularExpressions.Group
      System.Text.RegularExpressions.Match

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Match メンバ
System.Text.RegularExpressions 名前空間

Match プロパティ

パブリック プロパティ

	名前	説明
	Captures	内側と左側が先の順序で、キャプチャ グループに一致したすべてのキャプチャ結果のコレクションを取得します。または、正規表現が RegexOptions.RightToLeft オプションを使用して変更されている場合は、内側と右端が先の順序で取得します。このコレクションには 0 個以上の項目が格納されています。 ( Group から継承されます。)
	Index	キャプチャした部分文字列の最初の文字が見つかった元の文字列内の位置。 ( Capture から継承されます。)
	Length	キャプチャした部分文字列の長さ。 ( Capture から継承されます。)
	Success	一致した対象が見つかったかどうかを示す値を取得します。 ( Group から継承されます。)
	Value	入力文字列からキャプチャした部分文字列を取得します。 ( Capture から継承されます。)

参照

関連項目

Match クラス
System.Text.RegularExpressions 名前空間

Match メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	NextMatch	一致する対象が最後に見つかった位置 (最後に一致した文字の後ろの文字) から開始して、次に一致する対象を検索した結果の Match を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Result	渡された置換パターンを展開して返します。たとえば、置換パターンが $1$2 の場合、Result は Groups[1].Value と Groups[2].Value (Visual Basic の場合は Groups(1).Value と Groups(2).Value) の組み合わせを返します。
	Synchronized	オーバーロードされます。
	ToString	入力文字列からキャプチャした部分文字列を取得します。 ( Capture から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

Match クラス
System.Text.RegularExpressions 名前空間

Match メンバ

1 回の正規表現検索に一致した結果を表します。

Match データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	Captures	内側と左側が先の順序で、キャプチャ グループに一致したすべてのキャプチャ結果のコレクションを取得します。または、正規表現が RegexOptions.RightToLeft オプションを使用して変更されている場合は、内側と右端が先の順序で取得します。このコレクションには 0 個以上の項目が格納されています。(Group から継承されます。)
	Index	キャプチャした部分文字列の最初の文字が見つかった元の文字列内の位置。(Capture から継承されます。)
	Length	キャプチャした部分文字列の長さ。(Capture から継承されます。)
	Success	一致した対象が見つかったかどうかを示す値を取得します。(Group から継承されます。)
	Value	入力文字列からキャプチャした部分文字列を取得します。(Capture から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	NextMatch	一致する対象が最後に見つかった位置 (最後に一致した文字の後ろの文字) から開始して、次に一致する対象を検索した結果の Match を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Result	渡された置換パターンを展開して返します。たとえば、置換パターンが $1$2 の場合、Result は Groups[1].Value と Groups[2].Value (Visual Basic の場合は Groups(1).Value と Groups(2).Value) の組み合わせを返します。
	Synchronized	オーバーロードされます。
	ToString	入力文字列からキャプチャした部分文字列を取得します。 (Capture から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

Match クラス
System.Text.RegularExpressions 名前空間