Excel.DataValidationRule interface

Пакет:

excel

Правило проверки данных содержит различные типы проверки данных. Вы можете использовать только один из них одновременно в соответствии с Excel.DataValidationType.

Комментарии

[ Набор API: ExcelApi 1.8 ]

Свойства

custom	Условия проверки настраиваемых данных.
date	Условия проверки данных даты.
decimal	Условия проверки десятичных данных.
list	Условия проверки данных списка.
textLength	Критерии проверки данных длины текста.
time	Условия проверки данных времени.
wholeNumber	Условия проверки целочислимого числа данных.

Сведения о свойстве

custom

Условия проверки настраиваемых данных.

custom?: Excel.CustomDataValidation;

Значение свойства

Excel.CustomDataValidation

Комментарии

[ Набор API: ExcelApi 1.8 ]

date

Условия проверки данных даты.

date?: Excel.DateTimeDataValidation;

Значение свойства

Excel.DateTimeDataValidation

Комментарии

[ Набор API: ExcelApi 1.8 ]

decimal

Условия проверки десятичных данных.

decimal?: Excel.BasicDataValidation;

Значение свойства

Excel.BasicDataValidation

Комментарии

[ Набор API: ExcelApi 1.8 ]

list

Условия проверки данных списка.

list?: Excel.ListDataValidation;

Значение свойства

Excel.ListDataValidation

Комментарии

[ Набор API: ExcelApi 1.8 ]

Примеры

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

Критерии проверки данных длины текста.

textLength?: Excel.BasicDataValidation;

Значение свойства

Excel.BasicDataValidation

Комментарии

[ Набор API: ExcelApi 1.8 ]

time

Условия проверки данных времени.

time?: Excel.DateTimeDataValidation;

Значение свойства

Excel.DateTimeDataValidation

Комментарии

[ Набор API: ExcelApi 1.8 ]

wholeNumber

Условия проверки целочислимого числа данных.

wholeNumber?: Excel.BasicDataValidation;

Значение свойства

Excel.BasicDataValidation

Комментарии

[ Набор API: ExcelApi 1.8 ]

Примеры

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