Regex.Replace メソッド

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options);

public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options);

static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 patternが現在のインスタンスで一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

静的 Replace(String, String, String, RegexOptions) メソッドは、指定された正規表現パターンを使用して Regex オブジェクトを構築し、インスタンス メソッドを呼び出 Replace(String, String)のと同じです。

replacement パラメーターは、input内の各一致を置き換える文字列を指定します。 replacement は、リテラル テキストと置換の任意の組み合わせで構成 できます。 置換は、置換パターンで認識される唯一の正規表現言語要素です。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

RightToLeft パラメーターにoptionsを指定すると、一致の検索は入力文字列の末尾から開始され、左に移動します。それ以外の場合は、入力文字列の先頭から検索が開始され、右に移動します。

注意 (呼び出し元)

このメソッドは、呼び出されるアプリケーション ドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。 アプリケーション ドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる InfiniteMatchTimeout値が使用されます。 パターン の一致を置き換える場合に推奨される静的メソッドは Replace(String, String, String, RegexOptions, TimeSpan)です。これにより、タイムアウト間隔を設定できます。

こちらもご覧ください

• RegexOptions
• 正規表現での置換
• 正規表現言語要素

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions, matchTimeout As TimeSpan) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 patternが現在のインスタンスで一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

静的 Replace(String, String, String, RegexOptions, TimeSpan) メソッドは、指定された正規表現パターンを使用して Regex オブジェクトを構築し、インスタンス メソッドを呼び出 Replace(String, String)のと同じです。

replacement パラメーターは、input内の各一致を置き換える文字列を指定します。 replacement は、リテラル テキストと置換の任意の組み合わせで構成 できます。 置換は、置換パターンで認識される唯一の正規表現言語要素です。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

RightToLeft パラメーターにoptionsを指定すると、一致の検索は入力文字列の末尾から開始され、左に移動します。それ以外の場合は、入力文字列の先頭から検索が開始され、右に移動します。

matchTimeout パラメーターは、パターン マッチング メソッドがタイムアウトするまでの一致の検索を試行する期間を指定します。タイムアウト間隔を設定すると、過剰なバックトラッキングに依存する正規表現が、近い一致を含む入力を処理するときに応答を停止するように見えるのを防ぐことができます。 matchTimeout は、メソッドが実行されるアプリケーション ドメインに対して定義されている既定のタイムアウト値をオーバーライドします。

注意 (呼び出し元)

matchTimeout パラメーターを適切な値 (2 秒など) に設定することをお勧めします。 InfiniteMatchTimeoutを指定してタイムアウトを無効にすると、正規表現エンジンのパフォーマンスが若干向上します。 ただし、タイムアウトは次の条件でのみ無効にする必要があります。

• 正規表現によって処理される入力が既知の信頼できるソースから派生した場合、または静的テキストで構成されている場合。 これにより、ユーザーによって動的に入力されたテキストが除外されます。

• 正規表現パターンが十分にテストされ、一致、一致しない、および近い一致が効率的に処理されるようにする場合。

• 正規表現パターンに、近い一致を処理するときに過剰なバックトラッキングを引き起こすことがわかっている言語要素が含まれている場合。

こちらもご覧ください

• RegexOptions
• 正規表現での置換
• 正規表現言語要素
• 正規表現でのバックトラッキング
• .NET での正規表現のベスト プラクティス

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count, int startat);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count, int startat);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int * int -> string

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer, startat As Integer) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 現在のインスタンスで正規表現パターンが一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

startatの詳細については、Match(String, Int32)の「解説」セクションを参照してください。

このメソッドは、最初の countMatch オブジェクトを evaluator デリゲートに渡します。

こちらもご覧ください

• MatchEvaluator
• 正規表現での置換
• 正規表現の言語 - クイック リファレンス

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 patternが現在のインスタンスで一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

このメソッドは、次のいずれかの条件に該当する場合に正規表現の一致を置き換える場合に役立ちます。置換文字列を正規表現置換パターンで簡単に指定できない、置換文字列が一致した文字列を処理した結果、または置換文字列が条件付き処理の結果を返す場合です。

このメソッドは、Matches(String, String) メソッドを呼び出し、返されたMatchCollection内の各Match オブジェクトをevaluator デリゲートに渡すことと同じです。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

RightToLeft パラメーターにoptionsを指定すると、一致の検索は入力文字列の末尾から開始され、左に移動します。それ以外の場合は、入力文字列の先頭から検索が開始され、右に移動します。

こちらもご覧ください

• MatchEvaluator
• RegexOptions
• 正規表現での置換
• 正規表現言語要素

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions, matchTimeout As TimeSpan) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 patternが現在のインスタンスで一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

このメソッドは、次のいずれかの条件に該当する場合に正規表現の一致を置き換える場合に役立ちます。置換文字列を正規表現置換パターンで簡単に指定できない、置換文字列が一致した文字列を処理した結果、または置換文字列が条件付き処理の結果を返す場合です。

このメソッドは、Matches(String, String) メソッドを呼び出し、返されたMatchCollection内の各Match オブジェクトをevaluator デリゲートに渡すことと同じです。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

RightToLeft パラメーターにoptionsを指定すると、一致の検索は入力文字列の末尾から開始され、左に移動します。それ以外の場合は、入力文字列の先頭から検索が開始され、右に移動します。

matchTimeout パラメーターは、パターン マッチング メソッドがタイムアウトするまでの一致の検索を試行する期間を指定します。matchTimeoutは、メソッドが実行されるアプリケーション ドメインに対して定義されている既定のタイムアウト値をオーバーライドします。

注意 (呼び出し元)

matchTimeout パラメーターを適切な値 (2 秒など) に設定することをお勧めします。 InfiniteMatchTimeoutを指定してタイムアウトを無効にすると、正規表現エンジンのパフォーマンスが若干向上します。 ただし、タイムアウトは次の条件でのみ無効にする必要があります。

• 正規表現によって処理される入力が既知の信頼できるソースから派生した場合、または静的テキストで構成されている場合。 これにより、ユーザーによって動的に入力されたテキストが除外されます。

• 正規表現パターンが十分にテストされ、一致、一致しない、および近い一致が効率的に処理されるようにする場合。

• 正規表現パターンに、近い一致を処理するときに過剰なバックトラッキングを引き起こすことがわかっている言語要素が含まれている場合。

こちらもご覧ください

• RegexOptions
• 正規表現での置換
• 正規表現言語要素
• 正規表現でのバックトラッキング
• .NET での正規表現のベスト プラクティス

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count, int startat);

public string Replace(string input, string replacement, int count, int startat);

member this.Replace : string * string * int * int -> string

Public Function Replace (input As String, replacement As String, count As Integer, startat As Integer) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 現在のインスタンスで正規表現パターンが一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

startatの詳細については、Match(String, Int32)の「解説」セクションを参照してください。

replacement パラメーターは、各一致を置き換え、置換をサポートする文字列を指定します。

countが負の値の場合、置換は文字列の末尾まで続きます。

こちらもご覧ください

• 正規表現での置換
• 正規表現の言語 - クイック リファレンス

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement);

public static string Replace(string input, string pattern, string replacement);

static member Replace : string * string * string -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 patternが現在のインスタンスで一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

静的 Replace(String, String, String) メソッドは、指定された正規表現パターンを使用して Regex オブジェクトを構築し、インスタンス メソッドを呼び出 Replace(String, String)のと同じです。

replacement パラメーターは、input内の各一致を置き換える文字列を指定します。 replacement は、リテラル テキストと置換の任意の組み合わせで構成 できます。 置換は、置換パターンで認識される唯一の正規表現言語要素です。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

注意 (呼び出し元)

このメソッドは、呼び出されるアプリケーション ドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。 アプリケーション ドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる InfiniteMatchTimeout値が使用されます。 パターン の一致を置き換える場合に推奨される静的メソッドは Replace(String, String, String, RegexOptions, TimeSpan)です。これにより、タイムアウト間隔を設定できます。

こちらもご覧ください

• 正規表現での置換
• 正規表現言語要素

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 patternが現在のインスタンスで一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

このメソッドは、次のいずれかの条件に該当する場合に正規表現の一致を置き換える場合に役立ちます。置換文字列を正規表現置換パターンで簡単に指定できない、置換文字列が一致した文字列を処理した結果、または置換文字列が条件付き処理の結果を返す場合です。

このメソッドは、Matches(String, String) メソッドを呼び出し、返されたMatchCollection内の各Match オブジェクトをevaluator デリゲートに渡すことと同じです。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

注意 (呼び出し元)

このメソッドは、呼び出されるアプリケーション ドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。 アプリケーション ドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる InfiniteMatchTimeout値が使用されます。 パターンの一致を評価および置換するための推奨される静的メソッドは Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)であり、タイムアウト間隔を設定できます。

こちらもご覧ください

• MatchEvaluator
• 正規表現での置換
• 正規表現言語要素

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count);

public string Replace(string input, string replacement, int count);

member this.Replace : string * string * int -> string

Public Function Replace (input As String, replacement As String, count As Integer) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 現在のインスタンスで正規表現パターンが一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

検索は、 input 文字列の先頭から開始されます。 replacement パラメーターは、各一致を置き換え、置換をサポートする文字列を指定します。

countが負の値の場合、置換は文字列の末尾まで続きます。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

こちらもご覧ください

• 正規表現の言語 - クイック リファレンス
• 正規表現での置換

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Function Replace (input As String, evaluator As MatchEvaluator) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 現在のインスタンスで正規表現パターンが一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

このメソッドは、次のいずれかの条件に該当する場合に正規表現の一致を置き換える場合に役立ちます。置換文字列を正規表現置換パターンで簡単に指定できない、置換文字列が一致した文字列を処理した結果、または置換文字列が条件付き処理の結果を返す場合です。

このメソッドは、Matches(String) メソッドを呼び出し、返されたMatchCollection内の各Match オブジェクトをevaluator デリゲートに渡すことと同じです。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

こちらもご覧ください

• MatchEvaluator
• 正規表現での置換
• 正規表現の言語 - クイック リファレンス

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement);

public string Replace(string input, string replacement);

member this.Replace : string * string -> string

Public Function Replace (input As String, replacement As String) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 現在のインスタンスで正規表現パターンが一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

パターンの検索は、 input 文字列の先頭から始まります。

replacement パラメーターは、各一致を置き換える文字列を指定します。 replacement は、リテラル テキストと置換の任意の組み合わせで構成 できます。 置換は、置換パターンで認識される唯一の正規表現言語要素です。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

こちらもご覧ください

• 正規表現の言語 - クイック リファレンス
• 正規表現での置換

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

ソース:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int -> string

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer) As String

パラメーター

返品

置換文字列が一致した各文字列の代わりに使用されることを除き、入力文字列と同じ新しい文字列。 現在のインスタンスで正規表現パターンが一致しない場合、メソッドは現在のインスタンスを変更せずに返します。

例外

注釈

このメソッドは、次のいずれかの条件に該当する場合に正規表現の一致を置き換える場合に役立ちます。置換文字列を正規表現置換パターンで簡単に指定できない、置換文字列が一致した文字列を処理した結果、または置換文字列が条件付き処理の結果を返す場合です。

このメソッドは、Matches(String) メソッドを呼び出し、返されたMatchCollection内の最初のcountMatch オブジェクトをevaluator デリゲートに渡すことと同じです。

countが負の値の場合、置換は文字列の末尾まで続きます。

一致しない場合、メソッド input 変更されずに返されるため、 ReferenceEquals(Object, Object) メソッドを使用して、メソッドが置換を行ったかどうかを判断できます。

こちらもご覧ください

• MatchEvaluator
• 正規表現での置換
• 正規表現の言語 - クイック リファレンス