DataValidation — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss understøtter at tilføje datavalideringsregler til celleområder. Valideringsregler administreres gennem ws.data_validations, en DataValidationCollection knyttet til hver Worksheet.
Enumerations: aspose.cells_foss
from aspose.cells_foss import (
DataValidationType, DataValidationOperator,
DataValidationAlertStyle, DataValidationImeMode,
DataValidation, DataValidationCollection,
)DataValidationType
DataValidationType er en IntEnum der identificerer typen af begrænsning, der skal anvendes.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
NONE | 0 | Ingen valideringsbegrænsning. |
WHOLE_NUMBER | 1 | Accepterer kun heltal. |
DECIMAL | 2 | Accepterer decimaltal. |
LIST | 3 | Accepterer værdier fra en rullemenu. |
DATE | 4 | Accepterer kun datoværdier. |
TIME | 5 | Accepterer kun tidsværdier. |
TEXT_LENGTH | 6 | Validerer efter tekstlængde. |
CUSTOM | 7 | Validerer ved brug af en brugerdefineret formel. |
DataValidationOperator
DataValidationOperator er en IntEnum der angiver sammenligningsoperatoren, der bruges med numeriske/dato-/tid-/længdebegrænsninger.
| Enumerations | Enumerations |
|---|---|
BETWEEN | 0 |
NOT_BETWEEN | 1 |
EQUAL | 2 |
NOT_EQUAL | 3 |
GREATER_THAN | 4 |
LESS_THAN | 5 |
GREATER_THAN_OR_EQUAL | 6 |
LESS_THAN_OR_EQUAL | 7 |
DataValidationAlertStyle
DataValidationAlertStyle er en IntEnum styrer, hvordan Excel reagerer, når ugyldige data indtastes.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
STOP | 0 | Afviser indtastningen og viser en fejlmeddelelse (standard). |
WARNING | 1 | Viser en advarsel, men tillader indtastningen. |
INFORMATION | 2 | Viser en informationsmeddelelse, men tillader altid indtastningen. |
DataValidationImeMode
DataValidationImeMode er en IntEnum styrer IME (Input Method Editor)-tilstanden for indtastning af østasiatisk tekst.
| Enumerations | Enumerations |
|---|---|
NO_CONTROL | 0 |
OFF | 1 |
ON | 2 |
DISABLED | 3 |
HIRAGANA | 4 |
FULL_KATAKANA | 5 |
HALF_KATAKANA | 6 |
FULL_ALPHA | 7 |
HALF_ALPHA | 8 |
FULL_HANGUL | 9 |
HALF_HANGUL | 10 |
DataValidation
En DataValidation objekt beskriver en enkelt valideringsregel og celleområdet (sqref) den gælder for.
Enumerations
DataValidation(sqref=None)| Enumerations | Enumerations | Enumerations |
|---|---|---|
sqref | `str | None` |
Enumerations
| Enumerations | Enumerations | Enumerations |
|---|---|---|
sqref | str | Celleområdet for denne regel (f.eks., "B2:B100"). |
type | DataValidationType | Valideringstype (heltal, decimal, liste, dato, tid, tekstlængde eller brugerdefineret). |
operator | DataValidationOperator | Sammenligningsoperator anvendt på formula1 (og formula2 for BETWEEN/NOT_BETWEEN). |
formula1 | str | Nedre grænse, listkilde (f.eks., '"Apple,Banana,Cherry"'), eller brugerdefineret formel. |
formula2 | str | Øvre grænse for BETWEEN og NOT_BETWEEN operatorer. |
alert_style | DataValidationAlertStyle | Hvordan Excel reagerer på ugyldig input (STOP, WARNING, eller INFORMATION). |
show_error_message | bool | True for at vise fejlmeddelelse-dialogen ved ugyldig input. |
error_title | str | Titel på fejl-dialogen (maks 32 tegn). |
error_message | str | Brødtekst i fejl-dialogen (maks 225 tegn). |
show_input_message | bool | True for at vise en inputprompt-besked, når cellen er valgt. |
input_title | str | Titel på inputprompten (maks 32 tegn). |
input_message | str | Brødtekst i inputprompten (maks 255 tegn). |
allow_blank | bool | True for at tillade tomme (blanke) celler uden at udløse fejlen. |
show_dropdown | bool | True for at vise en rullemenu-pil for listevalideringer. |
ime_mode | DataValidationImeMode | IME-tilstand for østasiatisk tekstinput. |
Enumerations
copy
validation.copy() -> DataValidationReturnerer en dyb kopi af denne valideringsregel.
DataValidationCollection
DataValidationCollection tilgås som ws.data_validations. Den administrerer alle valideringsregler på et regneark.
Enumerations
add
ws.data_validations.add(
sqref,
validation_type=None,
operator=None,
formula1=None,
formula2=None
) -> DataValidationOpretter og registrerer en ny valideringsregel i ét kald. Returnerer den oprettede DataValidation objekt.
add_validation
ws.data_validations.add_validation(validation: DataValidation) -> DataValidationRegistrerer en forudkonfigureret DataValidation objekt. Returnerer det samme objekt.
remove
ws.data_validations.remove(validation: DataValidation) -> boolFjerner en valideringsregel efter reference. Returnerer True hvis reglen blev fundet og fjernet.
remove_at
ws.data_validations.remove_at(index: int)Fjerner valideringsreglen ved den angivne nulbaserede indeks.
remove_by_range
ws.data_validations.remove_by_range(sqref: str) -> intFjerner alle valideringer, hvis sqref overlapper det angivne interval. Returnerer antallet af fjernede regler.
clear
ws.data_validations.clear()Fjerner alle valideringsregler fra regnearket.
get_validation
ws.data_validations.get_validation(cell_ref: str) -> DataValidation | NoneReturnerer valideringsreglen, der gælder for den angivne cellereference (f.eks.,)., "B5"), eller None hvis ingen gælder.
Egenskaber og iteration
| Enumerations | Enumerations |
|---|---|
count | Antal valideringsregler på dette regneark (kun læse). |
disable_prompts | bool — Indstil til True for at undertrykke alle input-message prompts globalt. |
__len__() | Enumerations count. |
__iter__() | Itererer over alle DataValidation objekter. |
__getitem__(index) | Returnerer DataValidation ved nulbaseret index. |
Enumerations
Dropdown-listevalidering
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")Numerisk intervalvalidering
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")