Freigeben über

Excel.DataValidationRule interface

  • Referenz
Paket:
excel

Eine Datenüberprüfungsregel enthält verschiedene Arten der Datenüberprüfung. Sie können nur jeweils eine davon gemäß Excel.DataValidationTypeverwenden.

Hinweise

[ API-Satz: ExcelApi 1.8 ]

Eigenschaften

custom

Kriterien für eine benutzerdefinierte Datenüberprüfung.
date

Kriterien für die Datenüberprüfung.
decimal

Kriterien für die dezimale Datenüberprüfung.
list

Führt die Kriterien für die Datenüberprüfung auf.
textLength

Überprüfungskriterien für Textlängendaten.
time

Kriterien für die Zeitdatenüberprüfung.
wholeNumber

Kriterien für die Datenvalidierung ganzer Zahlen.

Details zur Eigenschaft

custom

Kriterien für eine benutzerdefinierte Datenüberprüfung.

custom?: Excel.CustomDataValidation;

Eigenschaftswert

Excel.CustomDataValidation

Hinweise

[ API-Satz: ExcelApi 1.8 ]

date

Kriterien für die Datenüberprüfung.

date?: Excel.DateTimeDataValidation;

Eigenschaftswert

Excel.DateTimeDataValidation

Hinweise

[ API-Satz: ExcelApi 1.8 ]

decimal

Kriterien für die dezimale Datenüberprüfung.

decimal?: Excel.BasicDataValidation;

Eigenschaftswert

Excel.BasicDataValidation

Hinweise

[ API-Satz: ExcelApi 1.8 ]

list

Führt die Kriterien für die Datenüberprüfung auf.

list?: Excel.ListDataValidation;

Eigenschaftswert

Excel.ListDataValidation

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 nameRange = 
        sheet.tables.getItem("NameOptionsTable").columns.getItem("Baby Name").getDataBodyRange();

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

    const nameSourceRange = context.workbook.worksheets.getItem("Names").getRange("A1:A3");

    let approvedListRule = {
        list: {
            inCellDropDown: true,
            source: nameSourceRange
        }
    };
    nameRange.dataValidation.rule = approvedListRule;

    await context.sync();
});

textLength

Überprüfungskriterien für Textlängendaten.

textLength?: Excel.BasicDataValidation;

Eigenschaftswert

Excel.BasicDataValidation

Hinweise

[ API-Satz: ExcelApi 1.8 ]

time

Kriterien für die Zeitdatenüberprüfung.

time?: Excel.DateTimeDataValidation;

Eigenschaftswert

Excel.DateTimeDataValidation

Hinweise

[ API-Satz: ExcelApi 1.8 ]

wholeNumber

Kriterien für die Datenvalidierung ganzer Zahlen.

wholeNumber?: Excel.BasicDataValidation;

Eigenschaftswert

Excel.BasicDataValidation

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