Aspose.Cells FOSS - Aspose.Cells ФОСС
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss поддържа добавяне на правила за проверка на данни към клетъчни диапазони. Правилата за проверка се управляват чрез ws.data_validations, a DataValidationCollection прикрепен към всеки Worksheet.

Enumerations: aspose.cells_foss

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

DataValidationType

DataValidationType е IntEnum идентифицира типа ограничение, което да се приложи.

EnumerationsEnumerationsEnumerations
NONE0Няма ограничение за проверка.
WHOLE_NUMBER1Приема само цели числа.
DECIMAL2Приема десетични числа.
LIST3Приема стойности от падащ списък.
DATE4Приема само стойности за дата.
TIME5Приема само стойности за време.
TEXT_LENGTH6Валидира по дължина на текста.
CUSTOM7Валидира с помощта на персонализирана формула.

DataValidationOperator

DataValidationOperator е IntEnum указва оператора за сравнение, използван с числови/дата/време/дължина ограничения.

EnumerationsEnumerations
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle е IntEnum контролира как Excel реагира, когато се въведат невалидни данни.

EnumerationsEnumerationsEnumerations
STOP0Отхвърля въвеждането и показва диалог за грешка (по подразбиране).
WARNING1Показва предупреждение, но позволява въвеждането.
INFORMATION2Показва информационно съобщение, но винаги позволява въвеждането.

DataValidationImeMode

DataValidationImeMode е IntEnum контролира режима на IME (Input Method Editor) за въвеждане на източноазиатски текст.

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

DataValidation

Е DataValidation обектът описва едно правило за проверка и диапазона от клетки (sqref) се отнася за.

Enumerations 

DataValidation(sqref=None)
EnumerationsEnumerationsEnumerations
sqref`strNone`

Enumerations

EnumerationsEnumerationsEnumerations
sqrefstrОбхватът от клетки за това правило (например,., "B2:B100").
typeDataValidationTypeТип на проверката (цяло число, десетично, списък, дата, време, дължина на текста или персонализиран).
operatorDataValidationOperatorОператор за сравнение, приложен към formula1 (и formula2 за BETWEEN/NOT_BETWEEN).
formula1strДолен предел, източник на списъка (например,., '"Apple,Banana,Cherry"'), или персонализирана формула.
formula2strГорен предел за BETWEEN и NOT_BETWEEN оператори.
alert_styleDataValidationAlertStyleКак Excel реагира на невалиден вход (STOP, WARNING, или INFORMATION).
show_error_messageboolTrue за показване на диалогов прозорец с грешка при невалиден вход.
error_titlestrЗаглавие на диалоговия прозорец за грешка (максимум 32 знака).
error_messagestrТекст на диалоговия прозорец за грешка (максимум 225 знака).
show_input_messageboolTrue за показване на съобщение за въвеждане, когато клетката е избрана.
input_titlestrЗаглавие на съобщението за въвеждане (максимум 32 знака).
input_messagestrТекст на съобщението за въвеждане (максимум 255 знака).
allow_blankboolTrue за разрешаване на празни (празни) клетки без задействане на грешката.
show_dropdownboolTrue за показване на стрелка за падащо меню при валидация на списъци.
ime_modeDataValidationImeModeIME режим за въвеждане на източноазиатски текст.

Enumerations

copy 

validation.copy() -> DataValidation

Връща дълбоко копие на това правило за проверка.

DataValidationCollection

DataValidationCollection се достъпва като ws.data_validations. Той управлява всички правила за проверка в работен лист.

Enumerations

add 

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

Създава и регистрира ново правило за проверка с едно извикване. Връща създаденото DataValidation обект.

add_validation 

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

Регистрира предварително конфигуриран DataValidation обект. Връща същия обект.

remove 

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

Премахва правило за проверка по препратка. Връща True ако правилото беше намерено и премахнато.

remove_at 

ws.data_validations.remove_at(index: int)

Премахва правилото за валидиране на посочения нулево-базиран индекс.

remove_by_range 

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

Премахва всички валидации, чийто sqref се припокрива с дадения диапазон. Връща броя на премахнатите правила.

clear 

ws.data_validations.clear()

Премахва всички правила за валидиране от работния лист.

get_validation 

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

Връща правилото за валидация, което се прилага към дадената клетъчна референция (например,., "B5"), None ако никое не се прилага.

Свойства и итерация

EnumerationsEnumerations
countБрой правила за валидация в този работен лист (само за четене).
disable_promptsbool — Зададено на True за потискане на всички входни съобщения глобално.
__len__()Enumerations count.
__iter__()Итерира върху всички DataValidation обекти.
__getitem__(index)Връща DataValidation при нулева индексация index.

Enumerations

Валидация на падащ списък 

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")

Валидация на числов диапазон 

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")

Вижте също

 Български