Freigeben über


Excel.DataValidationRule interface

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

Hinweise

[ API-Satz: ExcelApi 1.8 ]

date

Kriterien für die Datenüberprüfung.

date?: Excel.DateTimeDataValidation;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.8 ]

decimal

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

decimal?: Excel.BasicDataValidation;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.8 ]

list

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

list?: Excel.ListDataValidation;

Eigenschaftswert

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

Hinweise

[ API-Satz: ExcelApi 1.8 ]

time

Kriterien für die Zeitdatenüberprüfung.

time?: Excel.DateTimeDataValidation;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.8 ]

wholeNumber

Kriterien für die Datenvalidierung ganzer Zahlen.

wholeNumber?: Excel.BasicDataValidation;

Eigenschaftswert

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