Project) (Application.ReplaceEx 方法

搜索未筛选的值在指定的域中,或在所有可用的字段,并将其替换为指定的值。

语法

表达式。ReplaceEx (field, test, value, replacement, replaceAll, next, MatchCase, FieldID, TestID, SearchAllFields)

表达式 返回 Application 对象的表达式。

参数

名称 必需/可选 数据类型 说明
Field 可选 String 要搜索的域的名称。
Test 可选 String 字段 与 值 之间进行比较的类型。 可以是 比较字符串之一。
值 可选 Variant 要与 “字段”中指定字段的值进行比较的值。
Replacement 可选 Variant (空字符串) 使用 “” 清除符合 Test 和 Value 指定测试的字段。
ReplaceAll 可选 Variant 如此 如果 Value的所有内容将被都替换。 假 如果只将被替换的第一个匹配项。 默认值为 False。
Next 可选 Variant 如此 如果项目搜索下匹配的下一个匹配项的搜索标准。 假 如果项目搜索功能的下一个匹配项。 默认值为 True。
MatchCase 可选 Variant 为 搜索条件要区分大小写。 默认值为 False。
FieldID 可选 Variant 字段标识号可以是 PjField 常量之一。 FieldID 优先于任何 Field 值。
TestID 可选 Variant 测试标识号可以是 PjComparison 常量之一。 TestID 优先于任何 Test 值。
SearchAllFields 可选 Variant 如果为 true,则替换所有可用字段中的指定值。 默认值为 False。 SearchAllFields优先于 Field和 FieldID。

比较字符串

比较字符串 说明
"equals" Field 的值等于 Value 。
"does not equal" Field 的值不等于 Value 。
"is greater than" Field 的值大于 Value 。
"is greater than or equal to" Field 的值大于或等于 Value 。
"is less than" Field 的值小于 Value 。
"is less than or equal to" Field 的值小于或等于 Value 。
"is within" Field 的值在 Value 之内。
"is not within" Field 的值不在 Value 之内。
"contains" 字段 包含 值 。
"does not contain" 字段 不包含 值 。
"contains exactly" 字段 恰好包含 值。

返回值

Boolean

True如果进行任何替换。否则为 False。

备注

使用 ReplaceEx 方法时不带参数,或不指定 Field、 Test 和 Value,将显示“ 替换 ”对话框,该对话框已为上一个状态设置了选项。 如果将 SearchAllFields 设置为 True,则编程使用仍需要 Field、 Test 和 Value 参数的值。

示例

以下示例中的任一行均可将所有可用域的集合中的“Bad”替换为“Good”。

Sub Bad2Good() 
    ReplaceEx Field:="Name", Test:="contains", Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
    ReplaceEx Field:="xx", Test:="xx", TestID:=pjCompareContains, Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
End Sub

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。