搜索未筛选的值在指定的域中,或在所有可用的字段,并将其替换为指定的值。
语法
表达式。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 支持和反馈,获取有关如何接收支持和提供反馈的指南。