跳到主要内容

Add

将数据验证添加到指定区域。

语法

expression.Add(Type, AlertStyle, Operator, Formula1, Formula2);

expression - 表示 ApiValidation 类的变量。

参数

名称必需/可选数据类型默认值描述
Type必需ValidationType验证类型。
AlertStyle可选ValidationAlertStyle验证警告样式。
Operator可选ValidationOperator数据验证运算符。
Formula1可选string | number | ApiRange数据验证中的第一个公式。
Formula2可选string | number | ApiRange数据验证中的第二个公式。

返回值

ApiValidation | null

示例

此示例向单元格范围添加数据验证规则。

// How to apply data validation to a range of cells.

// Get a range from the worksheet and add data validation to it.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange("A1").SetValue("Data Validation for decimal to be more than 10");
const range = worksheet.GetRange("A2:A3");
range.SetValue("10");
const validation = worksheet.GetRange("A2").GetValidation();
validation.Add("xlValidateDecimal", "xlValidAlertWarning", "xlGreater", "12");
worksheet.GetRange("A4").SetValue("Data Validation is now applied for A2 only");