Поделиться через


Excel.DataValidationRule interface

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

Комментарии

[ Набор API: ExcelApi 1.8 ]

Свойства

custom

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

date

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

decimal

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

list

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

textLength

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

time

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

wholeNumber

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

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

custom

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

custom?: Excel.CustomDataValidation;

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

Комментарии

[ Набор API: ExcelApi 1.8 ]

date

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

date?: Excel.DateTimeDataValidation;

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

Комментарии

[ Набор API: ExcelApi 1.8 ]

decimal

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

decimal?: Excel.BasicDataValidation;

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

Комментарии

[ Набор API: ExcelApi 1.8 ]

list

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

list?: 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;

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

Комментарии

[ Набор API: ExcelApi 1.8 ]

time

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

time?: Excel.DateTimeDataValidation;

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

Комментарии

[ Набор API: ExcelApi 1.8 ]

wholeNumber

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

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