Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss admite la incorporación de reglas de validación de datos a rangos de celdas. Las reglas de validación se gestionan a través de ws.data_validations, un DataValidationCollection adjunto a cada Worksheet.

ColladaSaveOptions: aspose.cells_foss

from aspose.cells_foss import (
    DataValidationType, DataValidationOperator,
    DataValidationAlertStyle, DataValidationImeMode,
    DataValidation, DataValidationCollection,
)

DataValidationType

DataValidationType es un IntEnum que identifica el tipo de restricción a aplicar.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
NONE0Sin restricción de validación.
WHOLE_NUMBER1Acepta solo enteros.
DECIMAL2Acepta números decimales.
LIST3Acepta valores de una lista desplegable.
DATE4Acepta solo valores de fecha.
TIME5Acepta solo valores de hora.
TEXT_LENGTH6Valida por la longitud del texto.
CUSTOM7Valida usando una fórmula personalizada.

DataValidationOperator

DataValidationOperator es un IntEnum especifica el operador de comparación usado con restricciones numéricas/fecha/hora/longitud.

ColladaSaveOptionsColladaSaveOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle es un IntEnum controla cómo reacciona Excel cuando se ingresan datos no válidos.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
STOP0Rechaza la entrada y muestra un cuadro de diálogo de error (por defecto).
WARNING1Muestra una advertencia pero permite la entrada.
INFORMATION2Muestra un mensaje informativo pero siempre permite la entrada.

DataValidationImeMode

DataValidationImeMode es un IntEnum controla el modo IME (Editor de Métodos de Entrada) para la introducción de texto de Asia Oriental.

ColladaSaveOptionsColladaSaveOptions
NO_CONTROL0
OFF1
ON2
DISABLED3
HIRAGANA4
FULL_KATAKANA5
HALF_KATAKANA6
FULL_ALPHA7
HALF_ALPHA8
FULL_HANGUL9
HALF_HANGUL10

DataValidation

A DataValidation el objeto describe una única regla de validación y el rango de celdas (sqref) a la que se aplica.

ColladaSaveOptions 

DataValidation(sqref=None)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqref`strNone`

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqrefstrEl rango de celdas para esta regla (p. ej., "B2:B100").
typeDataValidationTypeTipo de validación (número entero, decimal, lista, fecha, hora, longitud de texto o personalizado).
operatorDataValidationOperatorOperador de comparación aplicado a formula1 (y formula2 para BETWEEN/NOT_BETWEEN).
formula1strLímite inferior, origen de la lista (p. ej., '"Apple,Banana,Cherry"').
formula2strLímite superior para BETWEEN y NOT_BETWEEN operadores.
alert_styleDataValidationAlertStyleCómo responde Excel a una entrada no válida (STOP, WARNING, o INFORMATION).
show_error_messageboolTrue para mostrar el cuadro de diálogo de mensaje de error con una entrada no válida.
error_titlestrTítulo del cuadro de diálogo de error (máx. 32 caracteres).
error_messagestrCuerpo del cuadro de diálogo de error (máx. 225 caracteres).
show_input_messageboolTrue para mostrar un mensaje de solicitud de entrada cuando se selecciona la celda.
input_titlestrTítulo del mensaje de entrada (máx 32 caracteres).
input_messagestrCuerpo del mensaje de entrada (máx 255 caracteres).
allow_blankboolTrue para permitir celdas en blanco (vacías) sin generar el error.
show_dropdownboolTrue para mostrar una flecha desplegable en validaciones de lista.
ime_modeDataValidationImeModeModo IME para la entrada de texto de Asia Oriental.

ColladaSaveOptions

copy 

validation.copy() -> DataValidation

Devuelve una copia profunda de esta regla de validación.

DataValidationCollection

DataValidationCollection se accede como ws.data_validations. Gestiona todas las reglas de validación en una hoja de cálculo.

ColladaSaveOptions

add 

ws.data_validations.add(
    sqref,
    validation_type=None,
    operator=None,
    formula1=None,
    formula2=None
) -> DataValidation

Crea y registra una nueva regla de validación en una sola llamada. Devuelve la creada DataValidation objeto.

add_validation 

ws.data_validations.add_validation(validation: DataValidation) -> DataValidation

Registra un pre-configured DataValidation objeto. Devuelve el mismo objeto.

remove 

ws.data_validations.remove(validation: DataValidation) -> bool

Elimina una regla de validación por referencia. Devuelve True si la regla fue encontrada y eliminada.

remove_at 

ws.data_validations.remove_at(index: int)

Elimina la regla de validación en el índice base cero proporcionado.

remove_by_range 

ws.data_validations.remove_by_range(sqref: str) -> int

Elimina todas las validaciones cuya sqref se superpone al rango dado. Devuelve el número de reglas eliminadas.

clear 

ws.data_validations.clear()

Elimina todas las reglas de validación de la hoja de cálculo.

get_validation 

ws.data_validations.get_validation(cell_ref: str) -> DataValidation | None

Devuelve la regla de validación que se aplica a la referencia de celda dada (p. ej., "B5"), o None si no se aplica ninguna.

Propiedades e iteración

ColladaSaveOptionsColladaSaveOptions
countNúmero de reglas de validación en esta hoja de cálculo (solo lectura).
disable_promptsbool — Establecer en True para suprimir todos los mensajes de entrada globalmente.
__len__()ColladaSaveOptions count.
__iter__()Itera sobre todos los DataValidation objetos.
__getitem__(index)Devuelve el DataValidation en base cero index.

ColladaSaveOptions

Validación de lista desplegable 

from aspose.cells_foss import Workbook, DataValidationType, DataValidationAlertStyle

wb = Workbook()
ws = wb.worksheets[0]

# Write a label
ws.cells["A1"].put_value("Status")

# Add a dropdown list to A2:A20
dv = ws.data_validations.add(
    sqref="A2:A20",
    validation_type=DataValidationType.LIST,
    formula1='"Open,In Progress,Closed,Cancelled"',
)
dv.show_dropdown = True
dv.allow_blank = True
dv.alert_style = DataValidationAlertStyle.STOP
dv.show_error_message = True
dv.error_title = "Invalid Status"
dv.error_message = "Please select a value from the list."
dv.show_input_message = True
dv.input_title = "Status"
dv.input_message = "Choose a status from the dropdown."

wb.save("dropdown_validation.xlsx")

Validación de rango numérico 

from aspose.cells_foss import (
    Workbook, DataValidationType, DataValidationOperator,
    DataValidationAlertStyle,
)

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["B1"].put_value("Score (0–100)")

# Whole number between 0 and 100
dv = ws.data_validations.add(
    sqref="B2:B50",
    validation_type=DataValidationType.WHOLE_NUMBER,
    operator=DataValidationOperator.BETWEEN,
    formula1="0",
    formula2="100",
)
dv.allow_blank = False
dv.alert_style = DataValidationAlertStyle.WARNING
dv.show_error_message = True
dv.error_title = "Out of Range"
dv.error_message = "Score must be between 0 and 100."

wb.save("range_validation.xlsx")

Ver también

 Español