Validation

代表工作表区域的数据有效性规则

Validation 对象的具体属性和方法请参阅下方的列表。

方法列表

方法名	返回类型	简介
Add()	undefined	新增数据有效性规则
Modify()	undefined	修改数据有效性规则
Delete()	undefined	删除数据有效性规则

Add()

新增数据有效性规则

参数

属性	数据类型	默认值	必填	说明
Type	Enum		是	指定要对值进行的有效性测试的类型，可以是 Enum.XlDVType 中的值
AlertStyle	Enum		是	指定验证过程中显示的消息框所用的图表,可以是Enum.XlDVAlertStyle 中的值
Operator	Enum		否	指定用于将公式与单元格的值或xlBetween和xlNoteBetween中的值进行比较,比较两个公式的运算符，可以是 Enum.XlFormatConditionOperator 中的值
Formula1	String		否	数据验证公式中的第一部分，值不得超过 255 个字符
Formula2	String		否	当 Operator 参数为 xlBetween 或 xlNotBetween 时, 数据验证等式的第二部分（否则, 将忽略此参数）

示例

// 数据有效性对象
let validation = Application.Range('A1').Validation

// 添加数据验证,如果输入的值不是整数并且不在1~5之间（包括1和5），则显示警告样式
validation.Add({
  Type: Application.Enum.XlDVType.xlValidateWholeNumber,
  AlertStyle: Application.Enum.XlDVAlertStyle.xlValidAlertWarning,
  Operator: Application.Enum.XlFormatConditionOperator.xlBetween,
  Formula1: '1',
  Formula2: '5'
})

Modify()

修改数据有效性规则

参数

属性	数据类型	默认值	必填	说明
Type	Enum		是	指定要对值进行的有效性测试的类型，可以是 Enum.XlDVType 中的值
AlertStyle	Enum		是	指定验证过程中显示的消息框所用的图表,可以是Enum.XlDVAlertStyle 中的值
Operator	Enum		否	指定用于将公式与单元格的值或xlBetween和xlNoteBetween中的值进行比较,比较两个公式的运算符，可以是 Enum.XlFormatConditionOperator 中的值
Formula1	String		否	数据验证公式中的第一部分，值不得超过 255 个字符
Formula2	String		否	当 Operator 参数为 xlBetween 或 xlNotBetween 时, 数据验证等式的第二部分（否则, 将忽略此参数）

示例

// 数据有效性对象
let validation = Application.Range('A1').Validation
// 修改数据验证规则
validation.Modify({
  Type: Application.Enum.XlDVType.xlValidateWholeNumber,
  AlertStyle: Application.Enum.XlDVAlertStyle.xlValidAlertWarning,
  Operator: Application.Enum.XlFormatConditionOperator.xlNotBetween,
  Formula1: '23',
  Formula2: '105'
})

Delete()

删除数据有效性规则

示例

// 数据有效性对象
let validation = Application.Range('A1').Validation

validation.Delete()
```、