Excel.DataValidationErrorAlert interface

Paquet:

excel

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

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

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: "Stop",
        title: "Negative Number Entered"
    };

    await context.sync();
});

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 Excel.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

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

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

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

style

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

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

Valeur de propriété

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

Remarques

[ Ensemble 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

[ Ensemble d’API : ExcelApi 1.8 ]