Excel.DataValidationErrorAlert interface

Paket:

excel

Stellt die Fehlerwarnungseigenschaften für die Datenüberprüfung dar.

Hinweise

[ API-Satz: ExcelApi 1.8 ]

Beispiele

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

Eigenschaften

message	Stellt die Fehlermeldung dar.
showAlert	Gibt an, ob ein Fehlerwarnungsdialogfeld angezeigt wird, wenn ein Benutzer ungültige Daten eingibt. Der Standardwert ist true.
style	Weitere Informationen finden Excel.DataValidationAlertStyle Sie unter Typ der Datenüberprüfungswarnung.
title	Stellt den Titel des Fehlerwarnungsdialogfelds dar.

Details zur Eigenschaft

message

Stellt die Fehlermeldung dar.

message: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.8 ]

showAlert

Gibt an, ob ein Fehlerwarnungsdialogfeld angezeigt wird, wenn ein Benutzer ungültige Daten eingibt. Der Standardwert ist true.

showAlert: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.8 ]

style

Weitere Informationen finden Excel.DataValidationAlertStyle Sie unter Typ der Datenüberprüfungswarnung.

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

Eigenschaftswert

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

Hinweise

[ API-Satz: ExcelApi 1.8 ]

title

Stellt den Titel des Fehlerwarnungsdialogfelds dar.

title: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.8 ]