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.

EnumerationsEnumerationsEnumerations
NONE0Ingen valideringsbegrænsning.
WHOLE_NUMBER1Accepterer kun heltal.
DECIMAL2Accepterer decimaltal.
LIST3Accepterer værdier fra en rullemenu.
DATE4Accepterer kun datoværdier.
TIME5Accepterer kun tidsværdier.
TEXT_LENGTH6Validerer efter tekstlængde.
CUSTOM7Validerer ved brug af en brugerdefineret formel.

DataValidationOperator

DataValidationOperator er en IntEnum der angiver sammenligningsoperatoren, der bruges med numeriske/dato-/tid-/længdebegrænsninger.

EnumerationsEnumerations
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle er en IntEnum styrer, hvordan Excel reagerer, når ugyldige data indtastes.

EnumerationsEnumerationsEnumerations
STOP0Afviser indtastningen og viser en fejlmeddelelse (standard).
WARNING1Viser en advarsel, men tillader indtastningen.
INFORMATION2Viser en informationsmeddelelse, men tillader altid indtastningen.

DataValidationImeMode

DataValidationImeMode er en IntEnum styrer IME (Input Method Editor)-tilstanden for indtastning af østasiatisk tekst.

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

DataValidation

En DataValidation objekt beskriver en enkelt valideringsregel og celleområdet (sqref) den gælder for.

Enumerations

DataValidation(sqref=None)
EnumerationsEnumerationsEnumerations
sqref`strNone`

Enumerations

EnumerationsEnumerationsEnumerations
sqrefstrCelleområdet for denne regel (f.eks., "B2:B100").
typeDataValidationTypeValideringstype (heltal, decimal, liste, dato, tid, tekstlængde eller brugerdefineret).
operatorDataValidationOperatorSammenligningsoperator anvendt på formula1 (og formula2 for BETWEEN/NOT_BETWEEN).
formula1strNedre grænse, listkilde (f.eks., '"Apple,Banana,Cherry"'), eller brugerdefineret formel.
formula2strØvre grænse for BETWEEN og NOT_BETWEEN operatorer.
alert_styleDataValidationAlertStyleHvordan Excel reagerer på ugyldig input (STOP, WARNING, eller INFORMATION).
show_error_messageboolTrue for at vise fejlmeddelelse-dialogen ved ugyldig input.
error_titlestrTitel på fejl-dialogen (maks 32 tegn).
error_messagestrBrødtekst i fejl-dialogen (maks 225 tegn).
show_input_messageboolTrue for at vise en inputprompt-besked, når cellen er valgt.
input_titlestrTitel på inputprompten (maks 32 tegn).
input_messagestrBrødtekst i inputprompten (maks 255 tegn).
allow_blankboolTrue for at tillade tomme (blanke) celler uden at udløse fejlen.
show_dropdownboolTrue for at vise en rullemenu-pil for listevalideringer.
ime_modeDataValidationImeModeIME-tilstand for østasiatisk tekstinput.

Enumerations

copy

validation.copy() -> DataValidation

Returnerer 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
) -> DataValidation

Opretter og registrerer en ny valideringsregel i ét kald. Returnerer den oprettede DataValidation objekt.

add_validation

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

Registrerer en forudkonfigureret DataValidation objekt. Returnerer det samme objekt.

remove

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

Fjerner 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) -> int

Fjerner 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 | None

Returnerer valideringsreglen, der gælder for den angivne cellereference (f.eks.,)., "B5"), eller None hvis ingen gælder.

Egenskaber og iteration

EnumerationsEnumerations
countAntal valideringsregler på dette regneark (kun læse).
disable_promptsbool — 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")

Se også

 Dansk