Excel.DataValidationErrorAlert interface

Paket:

excel

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

Hinweise

API-Satz: ExcelApi 1.8

Verwendet von

• Excel.DataValidation: errorAlert

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: Excel.DataValidationAlertStyle.stop,
        title: "Negative Number Entered"
    };

    await context.sync();
});

Eigenschaften

message	Stellt die Fehlermeldung dar.
showAlert	Gibt an, ob ein Fehlermeldungsdialogfeld angezeigt werden soll, wenn ein Benutzer ungültige Daten eingibt. Der Standardwert ist true.
style	Weitere Informationen finden Sie unter Excel.DataValidationAlertStyle den Warnungstyp zur Datenüberprüfung.
title	Stellt den Titel des Dialogfelds "Fehlermeldung" dar.

Details zur Eigenschaft

message

Stellt die Fehlermeldung dar.

message: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.8

showAlert

Gibt an, ob ein Fehlermeldungsdialogfeld angezeigt werden soll, 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 Sie unter Excel.DataValidationAlertStyle den Warnungstyp zur Datenüberprüfung.

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

Eigenschaftswert

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

Hinweise

API-Satz: ExcelApi 1.8

title

Stellt den Titel des Dialogfelds "Fehlermeldung" dar.

title: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.8