Replace 函数 (Visual Basic)

  • 项目

更新：2007 年 11 月

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

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

参数

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

  • Find
    必选。搜索的子字符串。

  • Replacement
    必选。替换用的子字符串。

  • Start
    可选。Expression 中开始搜索子字符串的位置。如果省略，则假定为 1。

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

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

设置

Compare 参数可以具有下列值。

常数

说明

Binary

执行二进制比较

Text

执行文本比较

返回值

Replace 返回下列值。

If

Replace 返回

Find 的长度为零或 Nothing

Expression 的副本

Replace 的长度为零

Expression 的副本，不带 Find 匹配项

Expression 的长度为零或 Nothing，或者 Start 大于 Expression 的长度

Nothing

Count 是 0

Expression 的副本

异常

异常类型

错误号

条件

ArgumentException

5

Count < -1 或 Start <= 0。

如果正在升级使用无结构错误处理的 Visual Basic 6.0 应用程序，请参见“错误号”一列。（您可以根据 Number 属性（Err 对象）比较错误号。）然而，如果可能，应当考虑用 Visual Basic 的结构化异常处理概述替换这种错误控制。

备注

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

示例

本例说明 Replace 函数。

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

要求

命名空间：Microsoft.VisualBasic

**模块：**Strings

**程序集：**Visual Basic 运行库（在 Microsoft.VisualBasic.dll 中）

请参见

参考

字符串操作摘要

Filter 函数 (Visual Basic)

ArgumentException