Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss supporta l’aggiunta di regole di convalida dei dati a intervalli di celle. Le regole di convalida sono gestite tramite ws.data_validations, un DataValidationCollection collegato a ciascuno Worksheet.

ImageRenderOptions: aspose.cells_foss

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

DataValidationType

DataValidationType è un IntEnum che identifica il tipo di vincolo da applicare.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0Nessun vincolo di convalida.
WHOLE_NUMBER1Accetta solo numeri interi.
DECIMAL2Accetta numeri decimali.
LIST3Accetta valori da un elenco a discesa.
DATE4Accetta solo valori di data.
TIME5Accetta solo valori di ora.
TEXT_LENGTH6Convalida per lunghezza del testo.
CUSTOM7Convalida usando una formula personalizzata.

DataValidationOperator

DataValidationOperator è un IntEnum che specifica l’operatore di confronto usato con vincoli numerici/data/ora/lunghezza.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle è un IntEnum controllare come Excel reagisce quando vengono inseriti dati non validi.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0Rifiuta l’inserimento e mostra una finestra di errore (predefinito).
WARNING1Mostra un avviso ma consente l’inserimento.
INFORMATION2Mostra un messaggio informativo ma consente sempre l’inserimento.

DataValidationImeMode

DataValidationImeMode è un IntEnum controlla la modalità IME (Input Method Editor) per l’immissione di testo dell’Asia orientale.

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

DataValidation

Un DataValidation oggetto descrive una singola regola di convalida e l’intervallo di celle (sqref) a cui si applica.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrL’intervallo di celle per questa regola (ad es., "B2:B100").
typeDataValidationTypeTipo di convalida (numero intero, decimale, elenco, data, ora, lunghezza del testo o personalizzato).
operatorDataValidationOperatorOperatore di confronto applicato a formula1 (e formula2 per BETWEEN/NOT_BETWEEN).
formula1strLimite inferiore, origine dell’elenco (ad es., '"Apple,Banana,Cherry"'), o formula personalizzata.
formula2strLimite superiore per BETWEEN e NOT_BETWEEN operatori.
alert_styleDataValidationAlertStyleCome Excel risponde a un input non valido (STOP, WARNING, o INFORMATION).
show_error_messageboolTrue per visualizzare la finestra di dialogo del messaggio di errore in caso di input non valido.
error_titlestrTitolo della finestra di errore (max 32 caratteri).
error_messagestrCorpo della finestra di errore (max 225 caratteri).
show_input_messageboolTrue per visualizzare un messaggio di prompt di input quando la cella è selezionata.
input_titlestrTitolo del prompt di input (max 32 caratteri).
input_messagestrCorpo del prompt di input (max 255 caratteri).
allow_blankboolTrue per consentire celle vuote (vuote) senza attivare l’errore.
show_dropdownboolTrue per mostrare una freccia a discesa per le convalide a elenco.
ime_modeDataValidationImeModeModalità IME per l’immissione di testo dell’Asia orientale.

ImageRenderOptions

copia 

validation.copy() -> DataValidation

Restituisce una copia profonda di questa regola di convalida.

DataValidationCollection

DataValidationCollection è accessibile come ws.data_validations. Gestisce tutte le regole di convalida in un foglio di lavoro.

ImageRenderOptions

aggiungi 

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

Crea e registra una nuova regola di convalida in una sola chiamata. Restituisce la regola creata DataValidation oggetto.

add_validation 

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

Registra un preconfigurato DataValidation oggetto. Restituisce lo stesso oggetto.

rimuovi 

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

Rimuove una regola di convalida per riferimento. Restituisce True se la regola è stata trovata e rimossa.

remove_at 

ws.data_validations.remove_at(index: int)

Rimuove la regola di convalida all’indice a base zero specificato.

remove_by_range 

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

Rimuove tutte le convalide la cui sqref si sovrappone all’intervallo specificato. Restituisce il numero di regole rimosse.

clear 

ws.data_validations.clear()

Rimuove tutte le regole di convalida dal foglio di lavoro.

get_validation 

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

Restituisce la regola di convalida che si applica al riferimento di cella fornito (ad esempio,)., "B5"), o None se nessuno si applica.

Proprietà e iterazione

ImageRenderOptionsImageRenderOptions
countNumero di regole di convalida su questo foglio di lavoro (sola lettura).
disable_promptsbool — Imposta su True per sopprimere tutti i prompt dei messaggi di input a livello globale.
__len__()ImageRenderOptions count.
__iter__()Itera su tutti DataValidation oggetti.
__getitem__(index)Restituisce il DataValidation a indice basato su zero index.

ImageRenderOptions

Convalida elenco a discesa 

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

Convalida intervallo numerico 

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

Vedi anche

 Italiano