跳到主要内容

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 do I restrict what values a user can enter into a cell range in a spreadsheet?

// Enforce an input constraint on specific cells to prevent invalid entries in a spreadsheet.

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");