ExcelScript.BasicDataValidation interface

包:

ExcelScript

表示基本类型数据验证条件。

注解

示例

/**
 * This script creates a data validation rule for the range B1:B5.
 * All values in that range must be a positive number.
 * Attempts to enter other values are blocked and an error message appears.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range B1:B5 in the active worksheet.
  const currentSheet = workbook.getActiveWorksheet();
  const positiveNumberOnlyCells = currentSheet.getRange("B1:B5");

  // Create a data validation rule to only allow positive numbers.
  const positiveNumberValidation: ExcelScript.BasicDataValidation = {
    formula1: "0",
    operator: ExcelScript.DataValidationOperator.greaterThan
  };
  const positiveNumberOnlyRule: ExcelScript.DataValidationRule = {
    wholeNumber: positiveNumberValidation
  };

  // Set the rule on the range.
  const rangeDataValidation = positiveNumberOnlyCells.getDataValidation();
  rangeDataValidation.setRule(positiveNumberOnlyRule);

  // Create an alert to appear when data other than positive numbers are entered.
  const positiveNumberOnlyAlert: ExcelScript.DataValidationErrorAlert = {
    message: "Positive numbers only",
    showAlert: true,
    style: ExcelScript.DataValidationAlertStyle.stop,
    title: "Invalid data"
  };
  rangeDataValidation.setErrorAlert(positiveNumberOnlyAlert);
}

属性

formula1	当运算符属性设置为二进制运算符（例如 GreaterThan (左侧操作数是用户尝试在单元格) 输入的值时，指定右侧操作数。 使用三元运算符 Between 和 NotBetween 指定下限操作数。 例如，将 formula1 设置为 10，将运算符设置为 GreaterThan 意味着范围的有效数据必须大于 10。 设置值时，可以将其作为数字、范围对象或字符串公式传入， (字符串是字符串化数字、单元格引用（如“=A1”）或公式（如“=MIN (A1，B1) ”) ）。 检索值时，它将始终作为字符串公式返回，例如：“=10”、“=A1”、“=SUM (A1：B5) ”等。
formula2	使用三元运算符 Between 和 NotBetween 指定上限操作数。 不与二进制运算符一起使用，例如 GreaterThan。 设置值时，可以将其作为数字、范围对象或字符串公式传入， (字符串是字符串化数字、单元格引用（如“=A1”）或公式（如“=MIN (A1，B1) ”) ）。 检索值时，它将始终作为字符串公式返回，例如：“=10”、“=A1”、“=SUM (A1：B5) ”等。
operator	用于验证数据有效性的运算符。

属性详细信息

formula1

当运算符属性设置为二进制运算符（例如 GreaterThan (左侧操作数是用户尝试在单元格) 输入的值时，指定右侧操作数。 使用三元运算符 Between 和 NotBetween 指定下限操作数。 例如，将 formula1 设置为 10，将运算符设置为 GreaterThan 意味着范围的有效数据必须大于 10。 设置值时，可以将其作为数字、范围对象或字符串公式传入， (字符串是字符串化数字、单元格引用（如“=A1”）或公式（如“=MIN (A1，B1) ”) ）。 检索值时，它将始终作为字符串公式返回，例如：“=10”、“=A1”、“=SUM (A1：B5) ”等。

formula1: string | number | Range;

属性值

string | number | ExcelScript.Range

formula2

使用三元运算符 Between 和 NotBetween 指定上限操作数。 不与二进制运算符一起使用，例如 GreaterThan。 设置值时，可以将其作为数字、范围对象或字符串公式传入， (字符串是字符串化数字、单元格引用（如“=A1”）或公式（如“=MIN (A1，B1) ”) ）。 检索值时，它将始终作为字符串公式返回，例如：“=10”、“=A1”、“=SUM (A1：B5) ”等。

formula2?: string | number | Range;

属性值

string | number | ExcelScript.Range

operator

用于验证数据有效性的运算符。

operator: DataValidationOperator;

属性值

ExcelScript.DataValidationOperator