Compartir a través de


Excel.DataValidationRule interface

Una regla de validación de datos contiene diferentes tipos de validación de datos. Solo puede usar uno de ellos a la vez según .Excel.DataValidationType

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Propiedades

custom

Criterios de validación de datos personalizados.

date

Criterios de validación de datos de fecha.

decimal

Criterios de validación de datos decimales.

list

Criterios de validación de datos de lista.

textLength

Criterios de validación de datos de longitud de texto.

time

Criterios de validación de datos de tiempo.

wholeNumber

Criterios de validación de datos de número entero.

Detalles de las propiedades

custom

Criterios de validación de datos personalizados.

custom?: Excel.CustomDataValidation;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

date

Criterios de validación de datos de fecha.

date?: Excel.DateTimeDataValidation;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

decimal

Criterios de validación de datos decimales.

decimal?: Excel.BasicDataValidation;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

list

Criterios de validación de datos de lista.

list?: Excel.ListDataValidation;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

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

Criterios de validación de datos de longitud de texto.

textLength?: Excel.BasicDataValidation;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

time

Criterios de validación de datos de tiempo.

time?: Excel.DateTimeDataValidation;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

wholeNumber

Criterios de validación de datos de número entero.

wholeNumber?: Excel.BasicDataValidation;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

Ejemplos

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