Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss ondersteunt het toevoegen van gegevensvalidatieregels aan celbereiken. Validatieregels worden beheerd via ws.data_validations, een DataValidationCollection gekoppeld aan elke Worksheet.

Example: aspose.cells_foss

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

DataValidationType

DataValidationType is een IntEnum die het type beperking identificeert dat moet worden toegepast.

ExampleExampleExample
NONE0Geen validatiebeperking.
WHOLE_NUMBER1Accepteert alleen gehele getallen.
DECIMAL2Accepteert decimale getallen.
LIST3Accepteert waarden uit een vervolgkeuzelijst.
DATE4Accepteert alleen datumwaarden.
TIME5Accepteert alleen tijdwaarden.
TEXT_LENGTH6Valideert op tekstlengte.
CUSTOM7Valideert met behulp van een aangepaste formule.

DataValidationOperator

DataValidationOperator is een IntEnum die de vergelijkingsoperator specificeert die wordt gebruikt met numerieke/datum/tijd/lengtebeperkingen.

ExampleExample
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle is een IntEnum beheert hoe Excel reageert wanneer ongeldige gegevens worden ingevoerd.

ExampleExampleExample
STOP0Weigert de invoer en toont een foutdialoog (standaard).
WARNING1Toont een waarschuwing maar staat de invoer toe.
INFORMATION2Toont een informatief bericht maar staat de invoer altijd toe.

DataValidationImeMode

DataValidationImeMode is een IntEnum beheert de IME (Input Method Editor)-modus voor het invoeren van Oost-Aziatische tekst.

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

DataValidation

Een DataValidation object beschrijft een enkele validatieregel en het celbereik (sqref) waarop het van toepassing is.

Example 

DataValidation(sqref=None)
ExampleExampleExample
sqref`strNone`

Example

ExampleExampleExample
sqrefstrHet celbereik voor deze regel (bijv., "B2:B100").
typeDataValidationTypeValidatietype (geheel getal, decimaal, lijst, datum, tijd, tekstlengte, of aangepast).
operatorDataValidationOperatorVergelijkingsoperator toegepast op formula1 (en formula2 voor BETWEEN/NOT_BETWEEN).
formula1strOndergrens, lijstbron (bijv., '"Apple,Banana,Cherry"'), of aangepaste formule.
formula2strBovengrens voor BETWEEN en NOT_BETWEEN operatoren.
alert_styleDataValidationAlertStyleHoe Excel reageert op ongeldige invoer (STOP, WARNING, of INFORMATION).
show_error_messageboolTrue om het foutmeldingsdialoogvenster weer te geven bij ongeldige invoer.
error_titlestrTitel van het foutdialoog (max 32 tekens).
error_messagestrInhoud van het foutdialoog (max 225 tekens).
show_input_messageboolTrue om een invoerpromptbericht weer te geven wanneer de cel is geselecteerd.
input_titlestrTitel van de invoerprompt (max 32 tekens).
input_messagestrInhoud van de invoerprompt (max 255 tekens).
allow_blankboolTrue om lege (lege) cellen toe te staan zonder de fout te activeren.
show_dropdownboolTrue om een vervolgkeuzepijl weer te geven voor lijstvalidaties.
ime_modeDataValidationImeModeIME-modus voor invoer van Oost-Aziatische tekst.

Example

copy 

validation.copy() -> DataValidation

Retourneert een diepe kopie van deze validatieregel.

DataValidationCollection

DataValidationCollection wordt benaderd als ws.data_validations. Het beheert alle validatieregels op een werkblad.

Example

add 

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

Maakt een nieuwe validatieregel aan en registreert deze in één oproep. Retourneert de aangemaakte DataValidation object.

add_validation 

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

Registreert een vooraf geconfigureerde DataValidation object. Retourneert hetzelfde object.

remove 

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

Verwijdert een validatieregel op referentie. Retourneert True als de regel werd gevonden en verwijderd.

remove_at 

ws.data_validations.remove_at(index: int)

Verwijdert de validatieregel op de opgegeven nulgebaseerde index.

remove_by_range 

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

Verwijdert alle validaties waarvan de sqref overlap de opgegeven reeks. Retourneert het aantal verwijderde regels.

clear 

ws.data_validations.clear()

Verwijdert alle validatieregels van het werkblad.

get_validation 

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

Retourneert de validatieregel die van toepassing is op de opgegeven celreferentie (bijv., "B5"), of None als geen van toepassing is.

Eigenschappen en iteratie

ExampleExample
countAantal validatieregels op dit werkblad (alleen-lezen).
disable_promptsbool — Instellen op True om alle invoer‑bericht prompts wereldwijd te onderdrukken.
__len__()Example count.
__iter__()Doorloopt alle DataValidation objecten.
__getitem__(index)Retourneert de DataValidation op nul‑gebaseerde index.

Example

Dropdownlijstvalidatie 

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

Numerieke bereikvalidatie 

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

Zie ook

 Nederlands