FOSS (Fosul)
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss suportă adăugarea de reguli de validare a datelor la intervale de celule. Regulile de validare sunt gestionate prin ws.data_validations, un DataValidationCollection atașat fiecărui Worksheet.

ImageRenderOptions: aspose.cells_foss

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

DataValidationType

DataValidationType este un IntEnum care identifică tipul de constrângere de aplicat.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0Nicio constrângere de validare.
WHOLE_NUMBER1Acceptă doar numere întregi.
DECIMAL2Acceptă numere zecimale.
LIST3Acceptă valori dintr-o listă derulantă.
DATE4Acceptă doar valori de dată.
TIME5Acceptă doar valori de timp.
TEXT_LENGTH6Validează prin lungimea textului.
CUSTOM7Validează utilizând o formulă personalizată.

DataValidationOperator

DataValidationOperator este un IntEnum specificând operatorul de comparație utilizat cu constrângerile numerice/date/timp/lungime.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle este un IntEnum controlând modul în care Excel reacționează când sunt introduse date invalide.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0Respinge intrarea și afișează un dialog de eroare (implicit).
WARNING1Afișează un avertisment, dar permite intrarea.
INFORMATION2Afișează un mesaj informativ, dar permite întotdeauna intrarea.

DataValidationImeMode

DataValidationImeMode este un IntEnum controlând modul IME (Input Method Editor) pentru introducerea de text din Asia de Est.

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

DataValidation

A DataValidation obiectul descrie o regulă de validare unică și intervalul de celule (sqref) la care se aplică.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrIntervalul de celule pentru această regulă (de ex., "B2:B100").
typeDataValidationTypeTipul de validare (număr întreg, zecimal, listă, dată, oră, lungime text, sau personalizat).
operatorDataValidationOperatorOperator de comparație aplicat la formula1 (și formula2 pentru BETWEEN/NOT_BETWEEN).
formula1strLimită inferioară, sursa listei (de exemplu,., '"Apple,Banana,Cherry"'),.
formula2strLimită superioară pentru BETWEEN și NOT_BETWEEN operatori.
alert_styleDataValidationAlertStyleCum răspunde Excel la o intrare invalidă (STOP, WARNING, sau INFORMATION).
show_error_messageboolTrue pentru a afișa dialogul de mesaj de eroare la o intrare invalidă.
error_titlestrTitlul dialogului de eroare (max 32 de caractere).
error_messagestrCorpul dialogului de eroare (max 225 de caractere).
show_input_messageboolTrue pentru a afișa un mesaj de solicitare de intrare când celula este selectată.
input_titlestrTitlul solicitării de intrare (max 32 de caractere).
input_messagestrCorpul solicitării de intrare (max 255 de caractere).
allow_blankboolTrue pentru a permite celule goale (vide) fără a declanșa eroarea.
show_dropdownboolTrue pentru a afișa o săgeată dropdown pentru validările de listă.
ime_modeDataValidationImeModeMod IME pentru introducerea de text din Asia de Est.

ImageRenderOptions

copy 

validation.copy() -> DataValidation

Returnează o copie profundă a acestei reguli de validare.

DataValidationCollection

DataValidationCollection este accesat ca ws.data_validations. Gestionează toate regulile de validare pe o foaie de calcul.

ImageRenderOptions

add 

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

Creează și înregistrează o nouă regulă de validare într-un singur apel. Returnează regula creată DataValidation obiect.

add_validation 

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

Înregistrează un obiect preconfigurat DataValidation obiect. Returnează același obiect.

remove 

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

Elimină o regulă de validare prin referință. Returnează True dacă regula a fost găsită și eliminată.

remove_at 

ws.data_validations.remove_at(index: int)

Elimină regula de validare de la indicele zero‑bazat specificat.

remove_by_range 

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

Elimină toate validările ale căror sqref se suprapun cu intervalul dat. Returnează numărul de reguli eliminate.

clear 

ws.data_validations.clear()

Elimină toate regulile de validare din foaia de calcul.

get_validation 

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

Returnează regula de validare care se aplică referinței de celulă date (de ex., "B5"), sau None dacă niciuna nu se aplică.

Proprietăți și iterare

ImageRenderOptionsImageRenderOptions
countNumărul de reguli de validare din această foaie de lucru (doar citire).
disable_promptsbool — Setat la True pentru a suprima toate mesajele de intrare la nivel global.
__len__()ImageRenderOptions count.
__iter__()Iterează peste toate DataValidation obiecte.
__getitem__(index)Returnează DataValidation la bază zero index.

ImageRenderOptions

Validare listă derulantă 

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

Validare interval numeric 

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

Vezi și

 Română