Match.Result(String) メソッド

定義

指定された置換パターンを展開して返します。

public:
 virtual System::String ^ Result(System::String ^ replacement);
public virtual string Result (string replacement);
abstract member Result : string -> string
override this.Result : string -> string
Public Overridable Function Result (replacement As String) As String

パラメーター

replacement
String

使用する置換パターン。

戻り値

replacement パラメーターの展開形式。

例外

replacementnullです。

このパターンは展開できません。

次の例では、かっこで囲まれた式を開始および終了するハイフンをかっこで置き換えます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "--(.+?)--";
      string replacement = "($1)";
      string input = "He said--decisively--that the time--whatever time it was--had come.";
      foreach (Match match in Regex.Matches(input, pattern))
      {
         string result = match.Result(replacement);
         Console.WriteLine(result);
      }
   }
}
// The example displays the following output:
//       (decisively)
//       (whatever time it was)
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "--(.+?)--"
      Dim replacement As String = "($1)"
      Dim input As String = "He said--decisively--that the time--whatever time it was--had come."
      For Each match As Match In Regex.Matches(input, pattern)
         Dim result As String = match.Result(replacement)
         Console.WriteLine(result)
      Next
   End Sub
End Module
' The example displays the following output:
'       (decisively)
'       (whatever time it was)

この正規表現パターン --(.+?)-- の解釈を次の表に示します。

パターン 説明
-- 2 つのハイフンと一致します。
(.+?) 任意の文字に 1 回以上一致しますが、可能な限り数回一致します。 これが最初のキャプチャ グループです。
-- 2 つのハイフンと一致します。

正規表現パターン --(.+?)-- では遅延量指定子 が使用されることに注意してください +?。 代わりに greedy 量指定子 + が使用された場合、正規表現エンジンは入力文字列内で 1 つの一致のみを検索します。

置換文字列 ($1) は、一致を最初にキャプチャしたグループに置き換えます。これはかっこで囲まれています。

注釈

メソッドは Regex.Replace 入力文字列内のすべての一致を指定された置換パターンに置き換えますが、メソッドは Result 1 つの一致を指定された置換パターンに置き換えます。 個々の一致に対して動作するため、メソッドを呼び出す前に、一致した文字列に対して処理を Result 実行することもできます。

パラメーターは replacement 標準の正規表現置換パターンです。 リテラル文字と正規表現の置換で構成できます。 詳細については、「 置換」を参照してください。

適用対象

こちらもご覧ください