Regex.Replace メソッド (String, String, String)

入力文字列の最初の文字から検索を開始し、正規表現によって定義されている文字パターンに一致するすべての対象を置換文字列で置き換えます。

Overloads Public Shared Function Replace( _
   ByVal input As String, _   ByVal pattern As String, _   ByVal replacement As String _) As String
[C#]
public static string Replace(stringinput,stringpattern,stringreplacement);
[C++]
public: static String* Replace(String* input,String* pattern,String* replacement);
[JScript]
public static function Replace(
   input : String,pattern : String,replacement : String) : String;

パラメータ

• input
  変更対象の文字列。
• pattern
  一致させる正規表現パターン。
• replacement
  置換文字列。

戻り値

変更後の文字列。

解説

置き換えは置換パターン内でだけ実行できます。正規表現の中で同様の機能を利用するには、\1 などの backreference を使用します。

文字のエスケープと置き換えは、置換パターンで認識される唯一の特殊な構成体です。その他のすべての構文構成体は正規表現だけで使用でき、置換パターンでは認識されません。たとえば、置換パターンが a*${test}b の場合は、文字列 "a*" が挿入され、その後ろに "test" キャプチャ グループと一致する部分文字列 (存在する場合) が続き、さらに文字列 "b" が続きます。* 文字は置換パターン内ではメタ文字として認識されません。同様に、$ パターンも正規表現一致パターン内では認識されません。正規表現内では、$ は文字列の末尾を示します。その他の例として、$123 はグループ番号 123 (10 進数) に一致した最後の部分文字列に置き換えられ、${name) は (?<name>) グループと一致する最後の部分文字列を置き換えられます。

静的 Replace メソッドは、正規表現パターンを指定して Regex オブジェクトを構築し、インスタンス メソッド Replace を呼び出す操作と同じです。この静的メソッドは、 Regex オブジェクトを明示的に作成しなくても、正規表現を単独で 1 回だけ使用できるようにする目的で用意されています。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

Regex クラス | Regex メンバ | System.Text.RegularExpressions 名前空間 | Regex.Replace オーバーロードの一覧