ExcelScript.BasicDataValidation interface

Paquete:

ExcelScript

Representa los criterios básicos de validación de datos de tipo.

Comentarios

Ejemplos

/**
 * 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);
}

Propiedades

formula1	Especifica el operando derecho cuando la propiedad operator se establece en un operador binario como GreaterThan (el operando izquierdo es el valor que el usuario intenta escribir en la celda). Con los operadores ternarios Between y NotBetween, especifica el operando de límite inferior. Por ejemplo, establecer formula1 en 10 y operador en GreaterThan significa que los datos válidos para el intervalo deben ser mayores que 10. Al establecer el valor, se puede pasar como un número, un objeto de rango o una fórmula de cadena (donde la cadena es un número stringified, una referencia de celda como "=A1", o una fórmula como "=MIN(A1, B1)"). Al recuperar el valor, siempre se devolverá como una fórmula de cadena, por ejemplo: "=10", "=A1", "=SUM(A1:B5)", etc.
formula2	Con los operadores ternarios Between y NotBetween, especifica el operando de límite superior. No se usa con los operadores binarios, como GreaterThan. Al establecer el valor, se puede pasar como un número, un objeto de rango o una fórmula de cadena (donde la cadena es un número stringified, una referencia de celda como "=A1", o una fórmula como "=MIN(A1, B1)"). Al recuperar el valor, siempre se devolverá como una fórmula de cadena, por ejemplo: "=10", "=A1", "=SUM(A1:B5)", etc.
operator	El operador para validar los datos.

Detalles de las propiedades

formula1

Especifica el operando derecho cuando la propiedad operator se establece en un operador binario como GreaterThan (el operando izquierdo es el valor que el usuario intenta escribir en la celda). Con los operadores ternarios Between y NotBetween, especifica el operando de límite inferior. Por ejemplo, establecer formula1 en 10 y operador en GreaterThan significa que los datos válidos para el intervalo deben ser mayores que 10. Al establecer el valor, se puede pasar como un número, un objeto de rango o una fórmula de cadena (donde la cadena es un número stringified, una referencia de celda como "=A1", o una fórmula como "=MIN(A1, B1)"). Al recuperar el valor, siempre se devolverá como una fórmula de cadena, por ejemplo: "=10", "=A1", "=SUM(A1:B5)", etc.

formula1: string | number | Range;

Valor de propiedad

string | number | ExcelScript.Range

formula2

Con los operadores ternarios Between y NotBetween, especifica el operando de límite superior. No se usa con los operadores binarios, como GreaterThan. Al establecer el valor, se puede pasar como un número, un objeto de rango o una fórmula de cadena (donde la cadena es un número stringified, una referencia de celda como "=A1", o una fórmula como "=MIN(A1, B1)"). Al recuperar el valor, siempre se devolverá como una fórmula de cadena, por ejemplo: "=10", "=A1", "=SUM(A1:B5)", etc.

formula2?: string | number | Range;

Valor de propiedad

string | number | ExcelScript.Range

operator

El operador para validar los datos.

operator: DataValidationOperator;

Valor de propiedad

ExcelScript.DataValidationOperator