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 的副本 |
异常
异常类型 |
错误号 |
条件 |
---|---|---|
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")
要求
**模块:**Strings
**程序集:**Visual Basic 运行库(在 Microsoft.VisualBasic.dll 中)