DataValidation — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss รองรับการเพิ่มกฎการตรวจสอบข้อมูลให้กับช่วงเซลล์ กฎการตรวจสอบข้อมูลถูกจัดการผ่าน ws.data_validations, a DataValidationCollection ที่แนบกับแต่ละ Worksheet.
Properties: aspose.cells_foss
from aspose.cells_foss import (
DataValidationType, DataValidationOperator,
DataValidationAlertStyle, DataValidationImeMode,
DataValidation, DataValidationCollection,
)DataValidationType
DataValidationType เป็น IntEnum ที่ระบุประเภทของข้อจำกัดที่จะใช้.
| Properties | Properties | Properties |
|---|---|---|
NONE | 0 | ไม่มีข้อจำกัดการตรวจสอบ. |
WHOLE_NUMBER | 1 | ยอมรับเฉพาะจำนวนเต็ม. |
DECIMAL | 2 | ยอมรับตัวเลขทศนิยม. |
LIST | 3 | ยอมรับค่าจากรายการดรอปดาวน์. |
DATE | 4 | ยอมรับเฉพาะค่าที่เป็นวันที่. |
TIME | 5 | ยอมรับเฉพาะค่าที่เป็นเวลา. |
TEXT_LENGTH | 6 | ตรวจสอบตามความยาวของข้อความ. |
CUSTOM | 7 | ตรวจสอบโดยใช้สูตรที่กำหนดเอง. |
DataValidationOperator
DataValidationOperator เป็น IntEnum ระบุโอเปอเรเตอร์การเปรียบเทียบที่ใช้กับข้อจำกัดเชิงตัวเลข/วันที่/เวลา/ความยาว.
| Properties | Properties |
|---|---|
BETWEEN | 0 |
NOT_BETWEEN | 1 |
EQUAL | 2 |
NOT_EQUAL | 3 |
GREATER_THAN | 4 |
LESS_THAN | 5 |
GREATER_THAN_OR_EQUAL | 6 |
LESS_THAN_OR_EQUAL | 7 |
DataValidationAlertStyle
DataValidationAlertStyle เป็น IntEnum ควบคุมวิธีที่ Excel ตอบสนองเมื่อมีการป้อนข้อมูลที่ไม่ถูกต้อง.
| Properties | Properties | Properties |
|---|---|---|
STOP | 0 | ปฏิเสธการป้อนข้อมูลและแสดงกล่องโต้ตอบข้อผิดพลาด (ค่าเริ่มต้น). |
WARNING | 1 | แสดงคำเตือนแต่อนุญาตให้ป้อนข้อมูล. |
INFORMATION | 2 | แสดงข้อความข้อมูลแต่อนุญาตให้ป้อนข้อมูลเสมอ. |
DataValidationImeMode
DataValidationImeMode เป็น IntEnum ควบคุมโหมด IME (Input Method Editor) สำหรับการป้อนข้อความภาษาตะวันออกเอเชีย.
| Properties | Properties |
|---|---|
NO_CONTROL | 0 |
OFF | 1 |
ON | 2 |
DISABLED | 3 |
HIRAGANA | 4 |
FULL_KATAKANA | 5 |
HALF_KATAKANA | 6 |
FULL_ALPHA | 7 |
HALF_ALPHA | 8 |
FULL_HANGUL | 9 |
HALF_HANGUL | 10 |
DataValidation
A DataValidation อ็อบเจ็กต์อธิบายกฎการตรวจสอบเดียวและช่วงเซลล์ (sqref) ที่ใช้กับ.
Properties
DataValidation(sqref=None)| Properties | Properties | Properties |
|---|---|---|
sqref | `str | None` |
Properties
| Properties | Properties | Properties |
|---|---|---|
sqref | str | ช่วงเซลล์สำหรับกฎนี้ (เช่น,., "B2:B100"). |
type | DataValidationType | ประเภทการตรวจสอบ (จำนวนเต็ม, ทศนิยม, รายการ, วันที่, เวลา, ความยาวข้อความ, หรือกำหนดเอง). |
operator | DataValidationOperator | ตัวดำเนินการเปรียบเทียบที่ใช้กับ formula1 (และ formula2 สำหรับ BETWEEN/NOT_BETWEEN). |
formula1 | str | ขอบเขตล่าง, แหล่งรายการ (เช่น,., '"Apple,Banana,Cherry"'), หรือสูตรที่กำหนดเอง. |
formula2 | str | ขอบบนสำหรับ BETWEEN และ NOT_BETWEEN ตัวดำเนินการ. |
alert_style | DataValidationAlertStyle | วิธีที่ Excel ตอบสนองต่อข้อมูลที่ไม่ถูกต้อง (STOP, WARNING, หรือ INFORMATION). |
show_error_message | bool | True เพื่อแสดงกล่องโต้ตอบข้อความแสดงข้อผิดพลาดเมื่อมีข้อมูลที่ไม่ถูกต้อง. |
error_title | str | หัวข้อของกล่องโต้ตอบข้อผิดพลาด (สูงสุด 32 ตัวอักษร). |
error_message | str | เนื้อหาของกล่องโต้ตอบข้อผิดพลาด (สูงสุด 225 ตัวอักษร). |
show_input_message | bool | True เพื่อแสดงข้อความแจ้งเตือนการป้อนข้อมูลเมื่อเลือกเซลล์. |
input_title | str | หัวข้อของการแจ้งเตือนการป้อนข้อมูล (สูงสุด 32 ตัวอักษร). |
input_message | str | เนื้อหาของการแจ้งเตือนการป้อนข้อมูล (สูงสุด 255 ตัวอักษร). |
allow_blank | bool | True เพื่ออนุญาตให้เซลล์ว่าง (ว่างเปล่า) โดยไม่ทำให้เกิดข้อผิดพลาด. |
show_dropdown | bool | True เพื่อแสดงลูกศรดรอปดาวน์สำหรับการตรวจสอบรายการ. |
ime_mode | DataValidationImeMode | โหมด IME สำหรับการป้อนข้อความภาษาตะวันออกเอเชีย. |
Properties
คัดลอก
validation.copy() -> DataValidationคืนค่าการคัดลอกเชิงลึกของกฎการตรวจสอบนี้.
DataValidationCollection
DataValidationCollection เข้าถึงได้เป็น ws.data_validations. มันจัดการกฎการตรวจสอบทั้งหมดบนแผ่นงาน.
Properties
add
ws.data_validations.add(
sqref,
validation_type=None,
operator=None,
formula1=None,
formula2=None
) -> DataValidationสร้างและลงทะเบียนกฎการตรวจสอบใหม่ในหนึ่งคำสั่ง คืนค่ากฎที่สร้างขึ้น DataValidation วัตถุ.
add_validation
ws.data_validations.add_validation(validation: DataValidation) -> DataValidationลงทะเบียนที่กำหนดล่วงหน้า DataValidation object. คืนค่าอ็อบเจ็กต์เดียวกัน.
remove
ws.data_validations.remove(validation: DataValidation) -> boolลบกฎการตรวจสอบโดยอ้างอิง คืนค่า True หากพบกฎและลบออกแล้ว.
remove_at
ws.data_validations.remove_at(index: int)ลบกฎการตรวจสอบที่ตำแหน่งดัชนีเริ่มจากศูนย์ที่ระบุ.
remove_by_range
ws.data_validations.remove_by_range(sqref: str) -> intลบการตรวจสอบทั้งหมดที่ sqref ทับซ้อนกับช่วงที่กำหนด คืนค่าจำนวนกฎที่ถูกลบ.
clear
ws.data_validations.clear()ลบกฎการตรวจสอบทั้งหมดออกจากแผ่นงาน.
get_validation
ws.data_validations.get_validation(cell_ref: str) -> DataValidation | Noneคืนค่ากฎการตรวจสอบที่ใช้กับอ้างอิงเซลล์ที่กำหนด (เช่น,., "B5"), หรือ None หากไม่มีใครใช้.
คุณสมบัติและการวนซ้ำ
| Properties | Properties |
|---|---|
count | จำนวนกฎการตรวจสอบในแผ่นงานนี้ (อ่านอย่างเดียว). |
disable_prompts | bool — ตั้งค่าเป็น True เพื่อปิดการแจ้งข้อความป้อนข้อมูลทั้งหมดทั่วโลก. |
__len__() | Properties count. |
__iter__() | วนซ้ำผ่านทั้งหมด DataValidation อ็อบเจ็กต์. |
__getitem__(index) | คืนค่า DataValidation ที่เริ่มจากศูนย์ index. |
Properties
การตรวจสอบรายการดรอปดาวน์
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")การตรวจสอบช่วงตัวเลข
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")