ExcelScript.BasicDataValidation interface

Paquet:

ExcelScript

Représente les critères de validation des données de type de base.

Remarques

Exemples

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

Propriétés

formula1	Spécifie l’opérande de droite lorsque la propriété de l’opérateur est définie sur un opérateur binaire tel que GreaterThan (l’opérande de gauche est la valeur que l’utilisateur tente d’entrer dans la cellule). Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite inférieure. Par exemple, la définition de formula1 sur 10 et de l’opérateur sur GreaterThan signifie que les données valides pour la plage doivent être supérieures à 10. Lors de la définition de la valeur, elle peut être passée en tant que nombre, objet de plage ou formule de chaîne (où la chaîne est soit un nombre stringifié, une référence de cellule comme « =A1 », soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(A1 :B5) », etc.
formula2	Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite supérieure. N’est pas utilisé avec les opérateurs binaires, tels que GreaterThan. Lors de la définition de la valeur, elle peut être passée en tant que nombre, objet de plage ou formule de chaîne (où la chaîne est soit un nombre stringifié, une référence de cellule comme « =A1 », soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(A1 :B5) », etc.
operator	L’opérateur à utiliser pour la validation des données.

Détails de la propriété

formula1

Spécifie l’opérande de droite lorsque la propriété de l’opérateur est définie sur un opérateur binaire tel que GreaterThan (l’opérande de gauche est la valeur que l’utilisateur tente d’entrer dans la cellule). Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite inférieure. Par exemple, la définition de formula1 sur 10 et de l’opérateur sur GreaterThan signifie que les données valides pour la plage doivent être supérieures à 10. Lors de la définition de la valeur, elle peut être passée en tant que nombre, objet de plage ou formule de chaîne (où la chaîne est soit un nombre stringifié, une référence de cellule comme « =A1 », soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(A1 :B5) », etc.

formula1: string | number | Range;

Valeur de propriété

string | number | ExcelScript.Range

formula2

Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite supérieure. N’est pas utilisé avec les opérateurs binaires, tels que GreaterThan. Lors de la définition de la valeur, elle peut être passée en tant que nombre, objet de plage ou formule de chaîne (où la chaîne est soit un nombre stringifié, une référence de cellule comme « =A1 », soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(A1 :B5) », etc.

formula2?: string | number | Range;

Valeur de propriété

string | number | ExcelScript.Range

operator

L’opérateur à utiliser pour la validation des données.

operator: DataValidationOperator;

Valeur de propriété

ExcelScript.DataValidationOperator