DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss støtter å legge til datavalideringsregler for celleområder. Valideringsregler administreres gjennom ws.data_validations, a DataValidationCollection festet til hver Worksheet.

Example: aspose.cells_foss

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

DataValidationType

DataValidationType er en IntEnum som identifiserer typen begrensning som skal brukes.

Example	Example	Example
`NONE`	0	Ingen valideringsbegrensning.
`WHOLE_NUMBER`	1	Godtar kun heltall.
`DECIMAL`	2	Godtar desimaltall.
`LIST`	3	Godtar verdier fra en rullegardinliste.
`DATE`	4	Godtar kun datoverdier.
`TIME`	5	Godtar kun tidsverdier.
`TEXT_LENGTH`	6	Validerer etter tekstlengde.
`CUSTOM`	7	Validerer ved hjelp av en egendefinert formel.

DataValidationOperator

DataValidationOperator er en IntEnum som spesifiserer sammenligningsoperatoren som brukes med numeriske/dato-/tid-/lengdebegrensninger.

Example	Example
`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 kontrollerer hvordan Excel reagerer når ugyldige data blir skrevet inn.

Example	Example	Example
`STOP`	0	Avviser oppføringen og viser en feildialog (standard).
`WARNING`	1	Viser en advarsel, men tillater oppføringen.
`INFORMATION`	2	Viser en informasjonsmelding, men tillater alltid oppføringen.

DataValidationImeMode

DataValidationImeMode er en IntEnum styrer IME (Input Method Editor)-modus for innlegging av østasiatisk tekst.

Example	Example
`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 gjelder for.

Example

DataValidation(sqref=None)

Example	Example	Example
`sqref`	`str	None`

Example

Example	Example	Example
`sqref`	`str`	Celleområdet for denne regelen (f.eks., `"B2:B100"`).
`type`	`DataValidationType`	Valideringstype (helt tall, desimal, liste, dato, tid, tekstlengde eller egendefinert).
`operator`	`DataValidationOperator`	Sammenligningsoperator brukt på `formula1` (og `formula2` for `BETWEEN`/`NOT_BETWEEN`).
`formula1`	`str`	Nedre grense, listkilde (f.eks., `'"Apple,Banana,Cherry"'`), eller egendefinert formel.
`formula2`	`str`	Øvre grense 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 å vise feilmeldingsdialogen ved ugyldig inndata.
`error_title`	`str`	Tittel på feildialogen (maks 32 tegn).
`error_message`	`str`	Brødtekst i feildialogen (maks 225 tegn).
`show_input_message`	`bool`	`True` for å vise en inndataprompt når cellen er valgt.
`input_title`	`str`	Tittel på inndataprompten (maks 32 tegn).
`input_message`	`str`	Brødtekst i inndataprompten (maks 255 tegn).
`allow_blank`	`bool`	`True` for å tillate tomme (blanke) celler uten å utløse feilen.
`show_dropdown`	`bool`	`True` for å vise en rullegardinpil for listevalideringer.
`ime_mode`	`DataValidationImeMode`	IME-modus for østasiatisk tekstinndata.

Example

copy

validation.copy() -> DataValidation

Returnerer en dyp kopi av denne valideringsregelen.

DataValidationCollection

DataValidationCollection tilgås som ws.data_validations. Den administrerer alle valideringsregler i et regneark.

Example

add

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

Oppretter og registrerer en ny valideringsregel i ett kall. Returnerer den opprettede DataValidation objektet.

add_validation

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

Registrerer en forhåndskonfigurert DataValidation objekt. Returnerer samme objekt.

remove

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

Fjerner en valideringsregel ved referanse. Returnerer True hvis regelen ble funnet og fjernet.

remove_at

ws.data_validations.remove_at(index: int)

Fjerner valideringsregelen på den gitte nullbaserte indeksen.

remove_by_range

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

Fjerner alle valideringer som sqref overlapper det gitte området. Returnerer antall regler som ble fjernet.

clear

ws.data_validations.clear()

Fjerner alle valideringsregler fra regnearket.

get_validation

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

Returnerer valideringsregelen som gjelder for den gitte celle‑referansen (f.eks.,)., "B5"), eller None hvis ingen gjelder.

Egenskaper og iterasjon

Example	Example
`count`	Antall valideringsregler på dette regnearket (kun lesing).
`disable_prompts`	`bool` — Sett til `True` for å undertrykke alle innmatingsmeldingsspørringer globalt.
`__len__()`	Example `count`.
`__iter__()`	Itererer over alle `DataValidation` objekter.
`__getitem__(index)`	Returnerer `DataValidation` ved nullbasert `index`.

Example

Rullegardinlistevalidering

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 områdevalidering

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

DataValidation — Aspose.Cells FOSS for Python API Reference

DataValidationType

DataValidationOperator

DataValidationAlertStyle

DataValidationImeMode

DataValidation

Example

Example

Example

copy

DataValidationCollection

Example

add

add_validation

remove

remove_at

remove_by_range

clear

get_validation

Egenskaper og iterasjon

Example

Rullegardinlistevalidering

Numerisk områdevalidering

Se også