Excel.DataValidationErrorAlert interface

Paquet:
excel

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

Remarques

Jeu d’API : ExcelApi 1.8

Utilisateur

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Decision");
    const rankingRange = sheet.tables.getItem("NameOptionsTable").columns.getItem("Ranking").getDataBodyRange();

    // When you are developing, it is a good practice to
    // clear the dataValidation object with each run of your code.
    rankingRange.dataValidation.clear();

    let greaterThanZeroRule = {
        wholeNumber: {
            formula1: 0,
            operator: Excel.DataValidationOperator.greaterThan
        }
    };
    rankingRange.dataValidation.rule = greaterThanZeroRule;

    rankingRange.dataValidation.prompt = {
        message: "Please enter a positive number.",
        showPrompt: true,
        title: "Positive numbers only."
    };

    rankingRange.dataValidation.errorAlert = {
        message: "Sorry, only positive numbers are allowed",
        showAlert: true,
        style: Excel.DataValidationAlertStyle.stop,
        title: "Negative Number Entered"
    };

    await context.sync();
});

Propriétés

message

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

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

Pour plus d’informations, consultez Excel.DataValidationAlertStyle le type d’alerte de validation des données.
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

Remarques

Jeu d’API : ExcelApi 1.8

showAlert

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

showAlert: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.8

style

Pour plus d’informations, consultez Excel.DataValidationAlertStyle le type d’alerte de validation des données.

style: Excel.DataValidationAlertStyle | "Stop" | "Warning" | "Information";

Valeur de propriété

Excel.DataValidationAlertStyle | "Stop" | "Warning" | "Information"

Remarques

Jeu d’API : ExcelApi 1.8

title

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

title: string;

Valeur de propriété

string

Remarques

Jeu d’API : ExcelApi 1.8