capture

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

Capture クラス

単一の部分式キャプチャの結果を表します。Capture は、正常終了した単一のキャプチャで取得される 1 つの部分文字列を表します。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public Class Capture

Visual Basic (使用法)

Dim instance As Capture

C#

[SerializableAttribute] 
public class Capture

C++

[SerializableAttribute] 
public ref class Capture

J#

/** @attribute SerializableAttribute() */ 
public class Capture

JScript

SerializableAttribute 
public class Capture

解説

このオブジェクトは変更不可で、パブリック コンストラクタはありません。インスタンスは、Captures によって返されたコレクションを通じて返されます。Match クラスおよび Group クラスは Capture を拡張したクラスです。

使用例

Visual Basic

Dim text As String = "One
 fish two fish red fish blue fish"
Dim pat As String = "(?<1>\w+)\s+(?<2>fish)\s*"
' Compile the regular expression.
Dim r As New Regex(pat,
 RegexOptions.IgnoreCase)
' Match the regular expression pattern against a text string.
Dim m As Match = r.Match(text)        
While m.Success
   ' Display the first match and its capture set.
   System.Console.WriteLine("Match=[" + m.ToString()
 + "]")
   Dim cc As CaptureCollection = m.Captures
   Dim c As Capture
   For Each c In  cc
      System.Console.WriteLine("Capture=[" + c.ToString()
 + "]")
   Next c
   ' Display Group1 and its capture set.
   Dim g1 As Group = m.Groups(1)
   System.Console.WriteLine("Group1=[" + g1.ToString()
 + "]")
   Dim c1 As Capture
   For Each c1 In  g1.Captures
      System.Console.WriteLine("Capture1=[" + c1.ToString()
 + "]")
   Next c1
   ' Display Group2 and its capture set.
   Dim g2 As Group = m.Groups(2)
   System.Console.WriteLine("Group2=[" + g2.ToString()
 + "]")
   Dim c2 As Capture
   For Each c2 In  g2.Captures
      System.Console.WriteLine("Capture2=[" + c2.ToString()
 + "]")
   Next c2
   ' Advance to the next match.
   m = m.NextMatch()
End While

C#

string text = "One car red car blue car";
string pat = @"(?<1>\w+)\s+(?<2>car)\s*";
// Compile the regular expression.
Regex r = new Regex(pat, RegexOptions.IgnoreCase);
// Match the regular expression pattern against a text string.
Match m = r.Match(text);
while (m.Success) 
{
   // Display the first match and its capture set.
   System.Console.WriteLine("Match=[" + m + "]");
   CaptureCollection cc = m.Captures;
   foreach (Capture c in cc) 
   {
      System.Console.WriteLine("Capture=[" + c + "]");
   }
   // Display Group1 and its capture set.
   Group g1 = m.Groups[1];
   System.Console.WriteLine("Group1=[" + g1 + "]");
   foreach (Capture c1 in g1.Captures) 
   {
      System.Console.WriteLine("Capture1=[" + c1 + "]");
   }
   // Display Group2 and its capture set.
   Group g2 = m.Groups[2];
   System.Console.WriteLine("Group2=["+ g2 + "]");
   foreach (Capture c2 in g2.Captures) 
   {
      System.Console.WriteLine("Capture2=[" + c2 + "]");
   }
   // Advance to the next match.
   m = m.NextMatch();
}

C++

String^ text = "One car red car blue car";
String^ pat = "(?<1>\\w+)\\s+(?<2>car)\\s*";

// compile the regular expression.
Regex^ r = gcnew Regex( pat,RegexOptions::IgnoreCase );

// match the regular expression pattern against a text String.
Match^ m = r->Match(text);
while ( m->Success )
{
   // Display the first match and its capture set.
   Console::WriteLine( "Match=[{0}]", m );
   CaptureCollection^ cc = m->Captures;
   for each (Capture^ c in cc) 
   {
      System::Console::WriteLine("Capture=[" + c + "]");
   }
   // Display Group1 and its capture set.
   Group^ g1 = m->Groups[ 1 ];
   Console::WriteLine( "Group1=[{0}]", g1 );
   for each (Capture^ c1 in g1->Captures)
 
   {
      System::Console::WriteLine("Capture1=[" + c1 + "]");
   }
   // Display Group2 and its capture set.
   Group^ g2 = m->Groups[ 2 ];
   Console::WriteLine( "Group2=[{0}]", g2 );
   for each (Capture^ c2 in g2->Captures)
 
   {
      System::Console::WriteLine("Capture2=[" + c2 + "]");
   }
   // Advance to the next match.
   m = m->NextMatch();
}

J#

String text = "One car red car blue car";
String pat = "(?<1>\\w+)\\s+(?<2>car)\\s*";

// Compile the regular expression.
Regex r = new Regex(pat, RegexOptions.IgnoreCase);
// Match the regular expression pattern against a text string.
Match m = r.Match(text);

while (m.get_Success()) {
    // Display the first match and its capture set.
    System.Console.WriteLine("Match=[" + m + "]");
    CaptureCollection cc = m.get_Captures();
    for (int iCtr = 0; iCtr < cc.get_Count();
 iCtr++) {
        Capture c = (Capture)cc.get_Item(iCtr);
        System.Console.WriteLine("Capture=[" + c + "]");
    }

    // Display Group1 and its capture set.
    Group g1 = m.get_Groups().get_Item(1);
    System.Console.WriteLine("Group1=[" + g1 + "]");
    for (int iCtr = 0; iCtr < g1.get_Captures().get_Count();
 iCtr++) {
        Capture c1 = (Capture)g1.get_Captures().get_Item(iCtr);
        System.Console.WriteLine("Capture1=[" + c1 + "]");
    }

    // Display Group2 and its capture set.
    Group g2 = m.get_Groups().get_Item(2);
    System.Console.WriteLine("Group2=[" + g2 + "]");
    for (int iCtr = 0; iCtr < g2.get_Captures().get_Count();
 iCtr++) {
        Capture c2 = (Capture)g2.get_Captures().get_Item(iCtr);
        System.Console.WriteLine("Capture2=[" + c2 + "]");
    }

    // Advance to the next match.
    m = m.NextMatch();
}

JScript

var text : String = "One car red car blue car";
var pat : String = "(?<1>\\w+)\\s+(?<2>fish)\\s*";
// Compile the regular expression.
var r : Regex = new Regex(pat, RegexOptions.IgnoreCase);
// match the regex pattern against a text string
var m : Match = r.Match(text);
while (m.Success) {
    // Display the first match and its capture set.
    System.Console.WriteLine("Match=[" + m + "]");
    var cc : CaptureCollection = m.Captures;
    for (var c : Capture in cc) {
        System.Console.WriteLine("Capture=[" + c + "]");
    }
    // display Group1 and its capture set.
    var g1 : Group = m.Groups[1];
    System.Console.WriteLine("Group1=[" + g1 + "]");
    for (var c1 : Capture in g1.Captures) {
        System.Console.WriteLine("Capture1=[" + c1 + "]");
    }
    // display Group2 and its capture set.
    var g2 : Group = m.Groups[2];
    System.Console.WriteLine("Group2=["+ g2 + "]");
    for (var c2 : Capture in g2.Captures) {
        System.Console.WriteLine("Capture2=[" + c2 + "]");
    }
    // advance to the next match.
    m = m.NextMatch();
}

継承階層

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

スレッド セーフ

この型の 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

参照

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

Capture プロパティ

パブリック プロパティ

	名前	説明
	Value	入力文字列からキャプチャした部分文字列を取得します。

参照

関連項目

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

Capture メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。 入力文字列からキャプチャした部分文字列を取得します。

プロテクト メソッド

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

参照

関連項目

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

Capture メンバ

単一の部分式キャプチャの結果を表します。Capture は、正常終了した単一のキャプチャで取得される 1 つの部分文字列を表します。

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

パブリック プロパティ

	名前	説明
	Value	入力文字列からキャプチャした部分文字列を取得します。

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。 入力文字列からキャプチャした部分文字列を取得します。

プロテクト メソッド

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

参照

関連項目

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