Excel.DataValidationErrorAlert interface

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

Hinweise

API-Satz: ExcelApi 1.8

Verwendet von

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