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