Project) (Application.ReplaceEx 方法

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

语法

表达式ReplaceEx (fieldtestvaluereplacementreplaceAllnextMatchCaseFieldIDTestIDSearchAllFields)

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

参数

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

比较字符串

比较字符串 说明
"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 方法时不带参数,或不指定 FieldTestValue,将显示“ 替换 ”对话框,该对话框已为上一个状态设置了选项。 如果将 SearchAllFields 设置为 True,则编程使用仍需要 FieldTestValue 参数的值。

示例

以下示例中的任一行均可将所有可用域的集合中的“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 支持和反馈,获取有关如何接收支持和提供反馈的指南。