向指定区域添加数据验证。
语法
表达式。添加 (类型、 AlertStyle、 运算符、 Formula1、 Formula2)
表达式 表示 验证 对象的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 说明 |
|---|---|---|---|
| Type | 必需 | XlDVType | 有效性验证类型。 |
| AlertStyle | 可选 | Variant | 验证警报样式。 可以是以下 XlDVAlertStyle 常量之一: xlValidAlertInformation、 xlValidAlertStop 或 xlValidAlertWarning。 |
| Operator | 可选 | Variant | 数据验证运算符。 可以是以下 XlFormatConditionOperator 常量之一: xlBetween、 xlEqual、 xlGreater、 xlGreaterEqual、 xlLess、 xlLessEqual、 xlNotBetween 或 xlNotEqual。 |
| Formula1 | 可选 | Variant | 数据验证公式中的第一部分。 值不得超过 255 个字符。 |
| Formula2 | 可选 | Variant | 当 运算符 为 xlBetween 或 xlNotBetween 时,数据验证公式的第二部分 (否则,此参数) 被忽略。 |
备注
Add 方法所要求的参数依验证的类型而定,如下表所示。
| 有效性验证类型 | 参数 |
|---|---|
| xlValidateCustom | Formula1 为必需,Formula2 遭忽略。 Formula1 必须包含以下表达式:当数据输入有效时,表达式的计算结果为 True;否则,计算结果为 False。 |
| xlInputOnly | 使用 AlertStyle、Formula1 或 Formula2。 |
| xlValidateList | Formula1 为必需,Formula2 遭忽略。 Formula1 必须包含以逗号分隔的值列表,或对该列表的工作表引用。 |
| xlValidateWholeNumber、xlValidateDate、xlValidateDecimal、xlValidateTextLength 或 xlValidateTime | 必须指定 Formula1 或 Formula2 之一,或两者均指定。 |
如在 “数据验证” 对话框中一样, Formula1 和 Formula2 不能包含对表的结构化引用,例如 =Table1[Category]、 =COUNTIF(Table1[Category],A2)>0或 =MAX(Table1[Amount])。 传递结构化表引用会导致运行时错误 1004 (“应用程序定义或对象定义的错误”) ,即使相同的引用在工作表公式中有效。
要使规则基于表列,请通过定义的名称引用该列,如第二个示例所示。 例如,在“公式”选项卡上定义引用 (的名称 CategoryList =Table1[Category] ,选择“定义名称) ”,然后作为 Formula1 传递。"=CategoryList" 重命名表或列时,名称将更新,而将行添加到表中时,列表将增大。
如果无法使用定义的名称,可以将引用作为文本传递给 INDIRECT 函数,例如 "=INDIRECT(""Table1[Category]"")"。 因为 INDIRECT 按文本引用表和列,所以在重命名任何一个值后,规则都会拒绝每个值。
INDIRECT 也是一个可变函数。
示例
本示例向单元格 E5 添加数据有效性验证。
With Range("e5").Validation
.Add Type:=xlValidateWholeNumber, _
AlertStyle:= xlValidAlertStop, _
Operator:=xlBetween, Formula1:="5", Formula2:="10"
.InputTitle = "Integers"
.ErrorTitle = "Integers"
.InputMessage = "Enter an integer from five to ten"
.ErrorMessage = "You must enter a number from five to ten"
End With
本示例将下拉列表添加到 Sheet1 上的单元格 D2,其项是表 Table1 的“类别”列中的值。 它假定工作簿有一个已定义的名称 CategoryList,该名称引用 =Table1[Category]。 直接作为 Formula1 传递"=Table1[Category]"会导致运行时错误 1004。
With Worksheets("Sheet1").Range("D2").Validation
.Delete
.Add Type:=xlValidateList, AlertStyle:=xlValidAlertStop, _
Formula1:="=CategoryList"
End With
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。