Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss menyokong penambahan peraturan pengesahan data kepada julat sel. Peraturan pengesahan diuruskan melalui ws.data_validations, sebuah DataValidationCollection yang dilampirkan kepada setiap Worksheet.

Example: aspose.cells_foss

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

DataValidationType

DataValidationType ialah satu IntEnum yang mengenal pasti jenis sekatan yang akan digunakan.

ExampleExampleExample
NONE0Tiada sekatan pengesahan.
WHOLE_NUMBER1Menerima hanya integer.
DECIMAL2Menerima nombor perpuluhan.
LIST3Menerima nilai daripada senarai lungsur.
DATE4Menerima hanya nilai tarikh.
TIME5Menerima hanya nilai masa.
TEXT_LENGTH6Mengesahkan mengikut panjang teks.
CUSTOM7Mengesahkan menggunakan formula tersuai.

DataValidationOperator

DataValidationOperator adalah satu IntEnum yang menentukan operator perbandingan yang digunakan dengan sekatan numerik/tarikh/masa/panjang.

ExampleExample
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle adalah satu IntEnum mengawal bagaimana Excel bertindak balas apabila data tidak sah dimasukkan.

ExampleExampleExample
STOP0Menolak entri dan memaparkan dialog ralat (lalai).
WARNING1Menunjukkan amaran tetapi membenarkan entri.
INFORMATION2Menunjukkan mesej maklumat tetapi sentiasa membenarkan entri.

DataValidationImeMode

DataValidationImeMode adalah satu IntEnum mengawal mod IME (Input Method Editor) untuk kemasukan teks Asia Timur.

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

DataValidation

Sebuah DataValidation objek menerangkan satu peraturan pengesahan dan julat sel (sqref) yang ia terpakai.

Example 

DataValidation(sqref=None)
ExampleExampleExample
sqref`strNone`

Example

ExampleExampleExample
sqrefstrJulat sel untuk peraturan ini (contohnya,., "B2:B100").
typeDataValidationTypeJenis pengesahan (nombor bulat, perpuluhan, senarai, tarikh, masa, panjang teks, atau khusus).
operatorDataValidationOperatorOperator perbandingan yang digunakan pada formula1 (dan formula2 untuk BETWEEN/NOT_BETWEEN).
formula1strHad bawah, sumber senarai (contohnya,., '"Apple,Banana,Cherry"'), atau formula khusus.
formula2strHad atas untuk BETWEEN dan NOT_BETWEEN operator.
alert_styleDataValidationAlertStyleBagaimana Excel bertindak balas terhadap input tidak sah (STOP, WARNING, atau INFORMATION).
show_error_messageboolTrue untuk memaparkan dialog mesej ralat pada input tidak sah.
error_titlestrTajuk dialog ralat (maksimum 32 aksara).
error_messagestrIsi dialog ralat (maksimum 225 aksara).
show_input_messageboolTrue untuk memaparkan mesej prompt input apabila sel dipilih.
input_titlestrTajuk prompt input (maksimum 32 aksara).
input_messagestrBadan prompt input (maksimum 255 aksara).
allow_blankboolTrue untuk membenarkan sel kosong (kosong) tanpa mencetuskan ralat.
show_dropdownboolTrue untuk memaparkan anak panah dropdown bagi pengesahan senarai.
ime_modeDataValidationImeModemod IME untuk input teks Asia Timur.

Example

copy 

validation.copy() -> DataValidation

Mengembalikan salinan mendalam bagi peraturan pengesahan ini.

DataValidationCollection

DataValidationCollection diakses sebagai ws.data_validations. Ia mengurus semua peraturan pengesahan pada lembar kerja.

Example

add 

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

Mencipta dan mendaftar peraturan pengesahan baru dalam satu panggilan. Mengembalikan yang dicipta DataValidation objek.

add_validation 

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

Mendaftar satu pra-konfigurasi DataValidation objek. Mengembalikan objek yang sama.

remove 

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

Membuang peraturan pengesahan mengikut rujukan. Mengembalikan True jika peraturan ditemui dan dibuang.

remove_at 

ws.data_validations.remove_at(index: int)

Membuang peraturan pengesahan pada indeks berasaskan sifar yang diberikan.

remove_by_range 

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

Membuang semua pengesahan yang sqref bertindih dengan julat yang diberikan. Mengembalikan bilangan peraturan yang dibuang.

clear 

ws.data_validations.clear()

Membuang semua peraturan pengesahan daripada helaian kerja.

get_validation 

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

Mengembalikan peraturan pengesahan yang terpakai pada rujukan sel yang diberikan (contoh,., "B5"), atau None jika tiada yang berkenaan.

Sifat dan Iterasi

ExampleExample
countBilangan peraturan pengesahan pada lembar kerja ini (baca-sahaja).
disable_promptsbool — Tetapkan kepada True untuk menekan semua prompt mesej input secara global.
__len__()Example count.
__iter__()Mengulangi atas semua DataValidation objek.
__getitem__(index)Mengembalikan DataValidation pada asas sifar index.

Example

Pengesahan Senarai Dropdown 

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

Pengesahan Julat Numerik 

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

Lihat Juga

 Bahasa Melayu