Regex.Replace 方法

定义

在指定的输入字符串中,将匹配正则表达式模式的字符串替换为指定的替换字符串。

重载

名称 说明
Replace(String, String, String, RegexOptions)

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为指定的替换字符串。 指定的选项修改匹配操作。

Replace(String, String, String, RegexOptions, TimeSpan)

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为指定的替换字符串。 其他参数指定修改匹配操作的选项,如果未找到匹配项,则指定超时间隔。

Replace(String, MatchEvaluator, Int32, Int32)

在指定的输入子字符串中,用委托返回的 MatchEvaluator 字符串替换与正则表达式模式匹配的指定最大字符串数。

Replace(String, String, MatchEvaluator, RegexOptions)

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为委托返回的 MatchEvaluator 字符串。 指定的选项修改匹配操作。

Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)

在指定的输入字符串中,将匹配指定正则表达式的所有子字符串替换为委托返回的 MatchEvaluator 字符串。 其他参数指定修改匹配操作的选项,如果未找到匹配项,则指定超时间隔。

Replace(String, String, Int32, Int32)

在指定的输入子字符串中,用指定的替换字符串替换与正则表达式模式匹配的指定最大字符串数。

Replace(String, String, String)

在指定的输入字符串中,将匹配指定正则表达式模式的所有字符串替换为指定的替换字符串。

Replace(String, String, MatchEvaluator)

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为委托返回的 MatchEvaluator 字符串。

Replace(String, String, Int32)

在指定的输入字符串中,用指定的替换字符串替换与正则表达式模式匹配的指定最大字符串数。

Replace(String, MatchEvaluator)

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为委托返回的 MatchEvaluator 字符串。

Replace(String, String)

在指定的输入字符串中,将匹配正则表达式模式的所有字符串替换为指定的替换字符串。

Replace(String, MatchEvaluator, Int32)

在指定的输入字符串中,用委托返回的 MatchEvaluator 字符串替换与正则表达式模式匹配的指定最大字符串数。

Replace(String, String, String, RegexOptions)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
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

参数

input
String

要搜索匹配项的字符串。

pattern
String

要匹配的正则表达式模式。

replacement
String

替换字符串。

options
RegexOptions

提供匹配选项的枚举值的按位组合。

返回

与输入字符串相同的新字符串,但替换字符串取代了每个匹配字符串的位置。 如果在 pattern 当前实例中不匹配,该方法将返回未更改的当前实例。

例外

发生正则表达式分析错误。

inputpatternreplacementnull

options 不是值的有效按位组合 RegexOptions

发生超时。

注解

静态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),这使你可以设置超时间隔。

另请参阅

适用于

Replace(String, String, String, RegexOptions, TimeSpan)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
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

参数

input
String

要搜索匹配项的字符串。

pattern
String

要匹配的正则表达式模式。

replacement
String

替换字符串。

options
RegexOptions

提供匹配选项的枚举值的按位组合。

matchTimeout
TimeSpan

超时间隔,或 InfiniteMatchTimeout 指示方法不应超时。

返回

与输入字符串相同的新字符串,但替换字符串取代了每个匹配字符串的位置。 如果在 pattern 当前实例中不匹配,该方法将返回未更改的当前实例。

例外

发生正则表达式分析错误。

inputpatternreplacementnull

options 不是值的有效按位组合 RegexOptions 。 - 或 - matchTimeout 为负、零或大于大约 24 天。

发生超时。

注解

静态Replace(String, String, String, RegexOptions, TimeSpan)方法等效于使用指定的正则表达式模式和调用实例方法Regex构造Replace(String, String)对象。

replacement 参数指定替换每个匹配项的 input字符串。 replacement 可以包含文本文本和 替换的任意组合。 替换是替换模式中唯一识别的正则表达式语言元素。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

如果为RightToLeft参数指定options,则搜索匹配项从输入字符串的末尾开始,并向左移动;否则,搜索从输入字符串的开头开始并向右移动。

matchTimeout 参数指定模式匹配方法在超时之前应尝试查找匹配的时间。设置超时间隔可防止依赖过度回溯的正则表达式在处理包含接近匹配项的输入时停止响应。 matchTimeout 重写为方法在其中执行的应用程序域定义的任何默认超时值。

调用方说明

建议将 matchTimeout 参数设置为适当的值,例如两秒。 如果通过指定 InfiniteMatchTimeout禁用超时,则正则表达式引擎的性能略有提高。 但是,应仅在以下情况下禁用超时:

  • 当正则表达式处理的输入派生自已知且受信任的源或包含静态文本时。 这不包括用户动态输入的文本。

  • 当正则表达式模式经过全面测试以确保它有效地处理匹配项、非匹配项和接近匹配项时。

  • 当正则表达式模式不包含任何已知在处理接近匹配时导致过度回溯的语言元素。

另请参阅

适用于

Replace(String, MatchEvaluator, Int32, Int32)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs

在指定的输入子字符串中,用委托返回的 MatchEvaluator 字符串替换与正则表达式模式匹配的指定最大字符串数。

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

参数

input
String

要搜索匹配项的字符串。

evaluator
MatchEvaluator

检查每个匹配项并返回原始匹配字符串或替换字符串的自定义方法。

count
Int32

将发生替换的最大次数。

startat
Int32

搜索开始的输入字符串中的字符位置。

返回

与输入字符串完全相同的新字符串,但替换字符串取代每个匹配字符串的位置。 如果在当前实例中不匹配正则表达式模式,该方法将返回当前实例不变。

例外

inputevaluatornull.

startat 小于零或大于长度 input

发生超时。

注解

有关更多详细信息 ,请参阅 “备注”部分。

该方法将第一个 countMatch 对象传递给 evaluator 委托。

另请参阅

适用于

Replace(String, String, MatchEvaluator, RegexOptions)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为委托返回的 MatchEvaluator 字符串。 指定的选项修改匹配操作。

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

参数

input
String

要搜索匹配项的字符串。

pattern
String

要匹配的正则表达式模式。

evaluator
MatchEvaluator

检查每个匹配项并返回原始匹配字符串或替换字符串的自定义方法。

options
RegexOptions

提供匹配选项的枚举值的按位组合。

返回

与输入字符串完全相同的新字符串,但替换字符串取代每个匹配字符串的位置。 如果在 pattern 当前实例中不匹配,该方法将返回未更改的当前实例。

例外

发生正则表达式分析错误。

inputpatternevaluatornull

options 不是值的有效按位组合 RegexOptions

发生超时。

注解

如果满足以下任一条件,则此方法可用于替换正则表达式匹配:替换字符串不能由正则表达式替换模式指定、替换字符串由处理匹配字符串的结果或条件处理中的替换字符串结果。

该方法等效于调用Matches(String, String)该方法并将返回MatchCollectionevaluator的每个对象传递给Match委托。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

如果为RightToLeft参数指定options,则搜索匹配项从输入字符串的末尾开始,并向左移动;否则,搜索从输入字符串的开头开始并向右移动。

另请参阅

适用于

Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs

在指定的输入字符串中,将匹配指定正则表达式的所有子字符串替换为委托返回的 MatchEvaluator 字符串。 其他参数指定修改匹配操作的选项,如果未找到匹配项,则指定超时间隔。

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

参数

input
String

要搜索匹配项的字符串。

pattern
String

要匹配的正则表达式模式。

evaluator
MatchEvaluator

检查每个匹配项并返回原始匹配字符串或替换字符串的自定义方法。

options
RegexOptions

提供匹配选项的枚举值的按位组合。

matchTimeout
TimeSpan

超时间隔,或 InfiniteMatchTimeout 指示方法不应超时。

返回

与输入字符串完全相同的新字符串,但替换字符串取代每个匹配字符串的位置。 如果在 pattern 当前实例中不匹配,该方法将返回未更改的当前实例。

例外

发生正则表达式分析错误。

inputpatternevaluatornull

options 不是值的有效按位组合 RegexOptions 。 - 或 - matchTimeout 为负、零或大于大约 24 天。

发生超时。

注解

如果满足以下任一条件,则此方法可用于替换正则表达式匹配:替换字符串不能由正则表达式替换模式指定、替换字符串由处理匹配字符串的结果或条件处理中的替换字符串结果。

该方法等效于调用Matches(String, String)该方法并将返回MatchCollectionevaluator的每个对象传递给Match委托。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

如果为RightToLeft参数指定options,则搜索匹配项从输入字符串的末尾开始,并向左移动;否则,搜索从输入字符串的开头开始并向右移动。

matchTimeout 参数指定模式匹配方法在超时 matchTimeout 之前应尝试查找匹配的时间。重写为方法在其中执行的应用程序域定义的任何默认超时值。

调用方说明

建议将 matchTimeout 参数设置为适当的值,例如两秒。 如果通过指定 InfiniteMatchTimeout禁用超时,则正则表达式引擎的性能略有提高。 但是,应仅在以下情况下禁用超时:

  • 当正则表达式处理的输入派生自已知且受信任的源或包含静态文本时。 这不包括用户动态输入的文本。

  • 当正则表达式模式经过全面测试以确保它有效地处理匹配项、非匹配项和接近匹配项时。

  • 当正则表达式模式不包含任何已知在处理接近匹配时导致过度回溯的语言元素。

另请参阅

适用于

Replace(String, String, Int32, Int32)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
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

参数

input
String

要搜索匹配项的字符串。

replacement
String

替换字符串。

count
Int32

可以替换的最大次数。

startat
Int32

搜索开始的输入字符串中的字符位置。

返回

与输入字符串相同的新字符串,但替换字符串取代了每个匹配字符串的位置。 如果在当前实例中不匹配正则表达式模式,该方法将返回当前实例不变。

例外

inputreplacementnull.

startat 小于零或大于长度 input

发生超时。

注解

有关更多详细信息 ,请参阅 “备注”部分。

replacement 参数指定替换每个匹配项并支持 替换的字符串。

如果 count 为负数,则替换操作继续到字符串的末尾。

另请参阅

适用于

Replace(String, String, String)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
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

参数

input
String

要搜索匹配项的字符串。

pattern
String

要匹配的正则表达式模式。

replacement
String

替换字符串。

返回

与输入字符串相同的新字符串,但替换字符串取代了每个匹配字符串的位置。 如果在 pattern 当前实例中不匹配,该方法将返回未更改的当前实例。

例外

发生正则表达式分析错误。

inputpatternreplacementnull

发生超时。

注解

静态Replace(String, String, String)方法等效于使用指定的正则表达式模式和调用实例方法Regex构造Replace(String, String)对象。

replacement 参数指定替换每个匹配项的 input字符串。 replacement 可以包含文本文本和 替换的任意组合。 替换是替换模式中唯一识别的正则表达式语言元素。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

调用方说明

此方法在一个时间间隔后超时,该值等于调用它的应用程序域的默认超时值。 如果未为应用程序域定义超时值,则使用阻止方法超时的值 InfiniteMatchTimeout。 用于替换模式匹配的推荐静态方法是 Replace(String, String, String, RegexOptions, TimeSpan),这使你可以设置超时间隔。

另请参阅

适用于

Replace(String, String, MatchEvaluator)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为委托返回的 MatchEvaluator 字符串。

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

参数

input
String

要搜索匹配项的字符串。

pattern
String

要匹配的正则表达式模式。

evaluator
MatchEvaluator

检查每个匹配项并返回原始匹配字符串或替换字符串的自定义方法。

返回

与输入字符串完全相同的新字符串,但替换字符串取代每个匹配字符串的位置。 如果在 pattern 当前实例中不匹配,该方法将返回未更改的当前实例。

例外

发生正则表达式分析错误。

inputpatternevaluatornull

发生超时。

注解

如果满足以下任一条件,则此方法可用于替换正则表达式匹配:替换字符串不能由正则表达式替换模式指定、替换字符串由处理匹配字符串的结果或条件处理中的替换字符串结果。

该方法等效于调用Matches(String, String)该方法并将返回MatchCollectionevaluator的每个对象传递给Match委托。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

调用方说明

此方法在一个时间间隔后超时,该值等于调用它的应用程序域的默认超时值。 如果未为应用程序域定义超时值,则使用阻止方法超时的值 InfiniteMatchTimeout。 建议用于评估和替换模式匹配的静态方法是 Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan),这使你可以设置超时间隔。

另请参阅

适用于

Replace(String, String, Int32)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
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
String

要搜索匹配项的字符串。

replacement
String

替换字符串。

count
Int32

可以替换的最大次数。

返回

与输入字符串相同的新字符串,但替换字符串取代了每个匹配字符串的位置。 如果在当前实例中不匹配正则表达式模式,该方法将返回当前实例不变。

例外

inputreplacementnull.

发生超时。

注解

搜索从字符串的 input 开头开始。 该 replacement 参数指定替换每个匹配项并支持 替换的字符串。

如果 count 为负数,则替换操作继续到字符串的末尾。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

另请参阅

适用于

Replace(String, MatchEvaluator)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs

在指定的输入字符串中,将匹配指定正则表达式的所有字符串替换为委托返回的 MatchEvaluator 字符串。

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

参数

input
String

要搜索匹配项的字符串。

evaluator
MatchEvaluator

检查每个匹配项并返回原始匹配字符串或替换字符串的自定义方法。

返回

与输入字符串完全相同的新字符串,但替换字符串取代每个匹配字符串的位置。 如果在当前实例中不匹配正则表达式模式,该方法将返回当前实例不变。

例外

inputevaluatornull.

发生超时。

注解

如果满足以下任一条件,则此方法可用于替换正则表达式匹配:替换字符串不能由正则表达式替换模式指定、替换字符串由处理匹配字符串的结果或条件处理中的替换字符串结果。

该方法等效于调用Matches(String)该方法并将返回MatchCollectionevaluator的每个对象传递给Match委托。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

另请参阅

适用于

Replace(String, String)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
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
String

要搜索匹配项的字符串。

replacement
String

替换字符串。

返回

与输入字符串相同的新字符串,但替换字符串取代了每个匹配字符串的位置。 如果在当前实例中不匹配正则表达式模式,该方法将返回当前实例不变。

例外

inputreplacementnull.

发生超时。

注解

搜索模式从字符串的 input 开头开始。

replacement 参数指定替换每个匹配项的字符串。 replacement 可以包含文本文本和 替换的任意组合。 替换是替换模式中唯一识别的正则表达式语言元素。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

另请参阅

适用于

Replace(String, MatchEvaluator, Int32)

Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs
Source:
Regex.Replace.cs

在指定的输入字符串中,用委托返回的 MatchEvaluator 字符串替换与正则表达式模式匹配的指定最大字符串数。

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

参数

input
String

要搜索匹配项的字符串。

evaluator
MatchEvaluator

检查每个匹配项并返回原始匹配字符串或替换字符串的自定义方法。

count
Int32

将发生替换的最大次数。

返回

与输入字符串完全相同的新字符串,但替换字符串取代每个匹配字符串的位置。 如果在当前实例中不匹配正则表达式模式,该方法将返回当前实例不变。

例外

inputevaluatornull.

发生超时。

注解

如果满足以下任一条件,则此方法可用于替换正则表达式匹配:替换字符串不能由正则表达式替换模式指定、替换字符串由处理匹配字符串的结果或条件处理中的替换字符串结果。

该方法等效于调用Matches(String)该方法并将返回MatchCollectionevaluator的第一个countMatch对象传递给委托。

如果 count 为负数,则替换操作继续到字符串的末尾。

由于方法在没有任何匹配项时 input 返回不变,因此可以使用 ReferenceEquals(Object, Object) 该方法来确定该方法是否进行了任何替换。

另请参阅

适用于