Partager via

ExcelScript.DataValidationErrorAlert interface

  • Référence
Paquet:
ExcelScript

Représente les propriétés d’alerte d’erreur pour la validation des données.

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

message

Représente le message d’alerte d’erreur.
showAlert

Spécifie s’il faut afficher une boîte de dialogue d’alerte d’erreur lorsqu’un utilisateur entre des données non valides. La valeur par défaut est true.
style

Le type d’alerte de validation des données, consultez ExcelScript.DataValidationAlertStyle pour plus d’informations.
title

Représente le titre de la boîte de dialogue d’alerte d’erreur.

Détails de la propriété

message

Représente le message d’alerte d’erreur.

message: string;

Valeur de propriété

string

showAlert

Spécifie s’il faut afficher une boîte de dialogue d’alerte d’erreur lorsqu’un utilisateur entre des données non valides. La valeur par défaut est true.

showAlert: boolean;

Valeur de propriété

boolean

style

Le type d’alerte de validation des données, consultez ExcelScript.DataValidationAlertStyle pour plus d’informations.

style: DataValidationAlertStyle;

Valeur de propriété

ExcelScript.DataValidationAlertStyle

title

Représente le titre de la boîte de dialogue d’alerte d’erreur.

title: string;

Valeur de propriété

string