Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss stöder att lägga till datavalideringsregler för cellområden. Valideringsregler hanteras genom ws.data_validations, en DataValidationCollection bifogad till varje Worksheet.

ImageRenderOptions: aspose.cells_foss

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

DataValidationType

DataValidationType är en IntEnum som identifierar vilken typ av begränsning som ska tillämpas.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0Ingen valideringsbegränsning.
WHOLE_NUMBER1Accepterar endast heltal.
DECIMAL2Accepterar decimaltal.
LIST3Accepterar värden från en rullgardinslista.
DATE4Accepterar endast datumvärden.
TIME5Accepterar endast tidsvärden.
TEXT_LENGTH6Validerar efter textlängd.
CUSTOM7Validerar med en anpassad formel.

DataValidationOperator

DataValidationOperator är en IntEnum som specificerar jämförelseoperatorn som används med numeriska/datum/tids/längdbegränsningar.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle är en IntEnum styr hur Excel reagerar när ogiltig data matas in.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0Avvisar inmatningen och visar en felruta (standard).
WARNING1Visar en varning men tillåter inmatningen.
INFORMATION2Visar ett informationsmeddelande men tillåter alltid inmatningen.

DataValidationImeMode

DataValidationImeMode är en IntEnum styr IME (Input Method Editor)-läget för inmatning av östasiatisk text.

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

DataValidation

En DataValidation objekt beskriver en enskild valideringsregel och cellintervallet (sqref) den gäller för.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrCellintervallet för denna regel (t.ex., "B2:B100").
typeDataValidationType) Valideringstyp (heltal, decimal, lista, datum, tid, textlängd eller anpassad).
operatorDataValidationOperatorJämförelseoperator som tillämpas på formula1 (och formula2 för BETWEEN/NOT_BETWEEN).
formula1strNedre gräns, listkälla (t.ex., '"Apple,Banana,Cherry"'), eller anpassad formel.
formula2strÖvre gräns för BETWEEN och NOT_BETWEEN operatorer.
alert_styleDataValidationAlertStyleHur Excel svarar på ogiltig inmatning (STOP, WARNING, eller INFORMATION).
show_error_messageboolTrue för att visa felmeddelandedialogen vid ogiltig inmatning.
error_titlestrTitel på felmeddelandedialogen (max 32 tecken).
error_messagestrBrödtext i felmeddelandedialogen (max 225 tecken).
show_input_messageboolTrue för att visa ett inmatningspromptmeddelande när cellen är markerad.
input_titlestrTitel på inmatningsprompten (max 32 tecken).
input_messagestrBrödtext i inmatningsprompten (max 255 tecken).
allow_blankboolTrue för att tillåta tomma (öppna) celler utan att utlösa felet.
show_dropdownboolTrue för att visa en rullgardinspil för listvalideringar.
ime_modeDataValidationImeModeIME-läge för östasiatisk textinmatning.

ImageRenderOptions

copy 

validation.copy() -> DataValidation

Returnerar en djup kopia av denna valideringsregel.

DataValidationCollection

DataValidationCollection åtkomst sker som ws.data_validations. Det hanterar alla valideringsregler i ett kalkylblad.

ImageRenderOptions

add 

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

Skapar och registrerar en ny valideringsregel i ett anrop. Returnerar den skapade DataValidation objektet.

add_validation 

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

Registrerar ett förkonfigurerat DataValidation objekt. Returnerar samma objekt.

remove 

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

Tar bort en valideringsregel genom referens. Returnerar True om regeln hittades och togs bort.

remove_at 

ws.data_validations.remove_at(index: int)

Tar bort valideringsregeln på det angivna nollbaserade indexet.

remove_by_range 

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

Tar bort alla valideringar vars sqref överskrider det angivna intervallet. Returnerar antalet regler som togs bort.

clear 

ws.data_validations.clear()

Tar bort alla valideringsregler från kalkylbladet.

get_validation 

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

Returnerar valideringsregeln som gäller för den angivna cellreferensen (t.ex., "B5"), eller None om ingen gäller.

Egenskaper och iteration

ImageRenderOptionsImageRenderOptions
countAntal valideringsregler på detta kalkylblad (skrivskyddad).
disable_promptsbool — Ställ in på True för att undertrycka alla inmatningsmeddelanden globalt.
__len__()ImageRenderOptions count.
__iter__()Itererar över alla DataValidation objekt.
__getitem__(index)Returnerar DataValidation vid nollbaserad index.

ImageRenderOptions

Rullgardinslistvalidering 

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 intervallvalidering 

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 även

 Svenska