Aspose.Cells FOSS (Tanah longsor)
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss mendukung penambahan aturan validasi data ke rentang sel. Aturan validasi dikelola melalui ws.data_validations, sebuah DataValidationCollection yang terlampir pada setiap Worksheet.

ImageRenderOptions: aspose.cells_foss

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

DataValidationType

DataValidationType adalah sebuah IntEnum yang mengidentifikasi jenis kendala yang akan diterapkan.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0Tidak ada kendala validasi.
WHOLE_NUMBER1Menerima hanya bilangan bulat.
DECIMAL2Menerima angka desimal.
LIST3Menerima nilai dari daftar dropdown.
DATE4Menerima hanya nilai tanggal.
TIME5Menerima hanya nilai waktu.
TEXT_LENGTH6Memvalidasi berdasarkan panjang teks.
CUSTOM7Memvalidasi menggunakan formula khusus.

DataValidationOperator

DataValidationOperator adalah sebuah IntEnum yang menentukan operator perbandingan yang digunakan dengan kendala numerik/tanggal/waktu/panjang.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle adalah sebuah IntEnum mengontrol cara Excel bereaksi saat data tidak valid dimasukkan.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0Menolak entri dan menampilkan dialog kesalahan (default).
WARNING1Menampilkan peringatan tetapi mengizinkan entri.
INFORMATION2Menampilkan pesan informatif tetapi selalu mengizinkan entri.

DataValidationImeMode

DataValidationImeMode adalah sebuah IntEnum mengontrol mode IME (Input Method Editor) untuk entri teks Asia Timur.

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

DataValidation

Sebuah DataValidation objek mendeskripsikan satu aturan validasi dan rentang sel (sqref) yang diterapkannya.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrRentang sel untuk aturan ini (misalnya,., "B2:B100").
typeDataValidationTypeJenis validasi (bilangan bulat, desimal, daftar, tanggal, waktu, panjang teks, atau kustom).
operatorDataValidationOperatorOperator perbandingan yang diterapkan pada formula1 (dan formula2 untuk BETWEEN/NOT_BETWEEN).
formula1strBatas bawah, sumber daftar (misalnya,., '"Apple,Banana,Cherry"'), atau rumus kustom.
formula2strBatas atas untuk BETWEEN dan NOT_BETWEEN operator.
alert_styleDataValidationAlertStyleBagaimana Excel merespons input tidak valid (STOP, WARNING, atau INFORMATION).
show_error_messageboolTrue untuk menampilkan dialog pesan kesalahan pada input yang tidak valid.
error_titlestrJudul dialog kesalahan (maksimum 32 karakter).
error_messagestrIsi dialog kesalahan (maksimum 225 karakter).
show_input_messageboolTrue untuk menampilkan pesan prompt input ketika sel dipilih.
input_titlestrJudul prompt input (maksimum 32 karakter).
input_messagestrIsi prompt input (maksimum 255 karakter).
allow_blankboolTrue untuk mengizinkan sel kosong (blank) tanpa memicu kesalahan.
show_dropdownboolTrue untuk menampilkan panah dropdown untuk validasi daftar.
ime_modeDataValidationImeModeMode IME untuk input teks Asia Timur.

ImageRenderOptions

copy 

validation.copy() -> DataValidation

Mengembalikan salinan mendalam dari aturan validasi ini.

DataValidationCollection

DataValidationCollection diakses sebagai ws.data_validations. Ini mengelola semua aturan validasi pada lembar kerja.

ImageRenderOptions

add 

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

Membuat dan mendaftarkan aturan validasi baru dalam satu panggilan. Mengembalikan yang dibuat DataValidation objek.

add_validation 

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

Mendaftarkan sebuah DataValidation objek. Mengembalikan objek yang sama.

hapus 

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

Menghapus aturan validasi berdasarkan referensi. Mengembalikan True jika aturan ditemukan dan dihapus.

remove_at 

ws.data_validations.remove_at(index: int)

Menghapus aturan validasi pada indeks berbasis nol yang diberikan.

remove_by_range 

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

Menghapus semua validasi yang sqref tumpang tindih dengan rentang yang diberikan. Mengembalikan jumlah aturan yang dihapus.

clear 

ws.data_validations.clear()

Menghapus semua aturan validasi dari lembar kerja.

get_validation 

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

Mengembalikan aturan validasi yang berlaku untuk referensi sel yang diberikan (misalnya,)., "B5"), atau None jika tidak ada yang berlaku.

Properti dan Iterasi

ImageRenderOptionsImageRenderOptions
countJumlah aturan validasi pada lembar kerja ini (hanya-baca).
disable_promptsbool — Atur ke True untuk menekan semua prompt pesan masukan secara global.
__len__()ImageRenderOptions count.
__iter__()Mengiterasi semua DataValidation objek.
__getitem__(index)Mengembalikan DataValidation pada basis nol index.

ImageRenderOptions

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

Validasi Rentang 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 Indonesia