Strings.Replace(String, String, String, Int32, Int32, CompareMethod) 方法

定义

命名空间:

Microsoft.VisualBasic

程序集:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

返回一个字符串，其中的指定子字符串已由另一个子字符串替换了指定的次数。

public static string? Replace (string? Expression, string? Find, string? Replacement, int Start = 1, int Count = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Replace : string * string * string * int * int * Microsoft.VisualBasic.CompareMethod -> string

Public Function Replace (Expression As String, Find As String, Replacement As String, Optional Start As Integer = 1, Optional Count As Integer = -1, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String

参数

Expression

String

必需。 字符串表达式，包含要替换的子字符串。

Find

String

必需。 搜索的子字符串。

Replacement

String

必需。 替换用的子字符串。

Start

Int32

可选。 Expression 内部要替换的子字符串的开始的位置。 Replace 的返回值是字符串，在 Start 开始，具有相应的子情况。 如果省略，则假定为 1。

Count

Int32

可选。 执行子字符串替换的数目。 如果省略，则默认值是 -1，表示“进行所有可能的替换”。

Compare

CompareMethod

可选。 数值，指示对子字符串求值时使用的比较类型。 具体的值请参见"设置"。

返回

String

以下值之一。

如果	Replace 返回
Find 的长度为零或 Nothing	Expression 的副本
Replace 的长度为零	Expression 的副本，不带 Find 匹配项
Expression 的长度为零或 Nothing，或者 Start 大于 Expression 的长度	Nothing
Count 是 0	Expression 的副本

例外

ArgumentException

Count< -1 或 Start<= 0。

示例

此示例演示 函数 Replace 。

Dim TestString As String = "Shopping List"  
' Returns "Shipping List".  
Dim aString As String = Replace(TestString, "o", "i")  

注解

函数的Replace返回值是一个字符串，该字符串从 指定Start的位置开始，并在字符串的Expression末尾结束，由 和 Replace 值指定Find进行替换。

参数 Compare 可以具有以下值。

返回的常量	说明
Binary	执行二进制比较
Text	执行文本比较

另请参阅

• Filter
• ArgumentException
• 字符串操作摘要