DataValidation

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 ที่ระบุประเภทของข้อจำกัดที่จะใช้.

PropertiesPropertiesProperties
NONE0ไม่มีข้อจำกัดการตรวจสอบ.
WHOLE_NUMBER1ยอมรับเฉพาะจำนวนเต็ม.
DECIMAL2ยอมรับตัวเลขทศนิยม.
LIST3ยอมรับค่าจากรายการดรอปดาวน์.
DATE4ยอมรับเฉพาะค่าที่เป็นวันที่.
TIME5ยอมรับเฉพาะค่าที่เป็นเวลา.
TEXT_LENGTH6ตรวจสอบตามความยาวของข้อความ.
CUSTOM7ตรวจสอบโดยใช้สูตรที่กำหนดเอง.

DataValidationOperator

DataValidationOperator เป็น IntEnum ระบุโอเปอเรเตอร์การเปรียบเทียบที่ใช้กับข้อจำกัดเชิงตัวเลข/วันที่/เวลา/ความยาว.

PropertiesProperties
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle เป็น IntEnum ควบคุมวิธีที่ Excel ตอบสนองเมื่อมีการป้อนข้อมูลที่ไม่ถูกต้อง.

PropertiesPropertiesProperties
STOP0ปฏิเสธการป้อนข้อมูลและแสดงกล่องโต้ตอบข้อผิดพลาด (ค่าเริ่มต้น).
WARNING1แสดงคำเตือนแต่อนุญาตให้ป้อนข้อมูล.
INFORMATION2แสดงข้อความข้อมูลแต่อนุญาตให้ป้อนข้อมูลเสมอ.

DataValidationImeMode

DataValidationImeMode เป็น IntEnum ควบคุมโหมด IME (Input Method Editor) สำหรับการป้อนข้อความภาษาตะวันออกเอเชีย.

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

DataValidation

A DataValidation อ็อบเจ็กต์อธิบายกฎการตรวจสอบเดียวและช่วงเซลล์ (sqref) ที่ใช้กับ.

Properties

DataValidation(sqref=None)
PropertiesPropertiesProperties
sqref`strNone`

Properties

PropertiesPropertiesProperties
sqrefstrช่วงเซลล์สำหรับกฎนี้ (เช่น,., "B2:B100").
typeDataValidationTypeประเภทการตรวจสอบ (จำนวนเต็ม, ทศนิยม, รายการ, วันที่, เวลา, ความยาวข้อความ, หรือกำหนดเอง).
operatorDataValidationOperatorตัวดำเนินการเปรียบเทียบที่ใช้กับ formula1 (และ formula2 สำหรับ BETWEEN/NOT_BETWEEN).
formula1strขอบเขตล่าง, แหล่งรายการ (เช่น,., '"Apple,Banana,Cherry"'), หรือสูตรที่กำหนดเอง.
formula2strขอบบนสำหรับ BETWEEN และ NOT_BETWEEN ตัวดำเนินการ.
alert_styleDataValidationAlertStyleวิธีที่ Excel ตอบสนองต่อข้อมูลที่ไม่ถูกต้อง (STOP, WARNING, หรือ INFORMATION).
show_error_messageboolTrue เพื่อแสดงกล่องโต้ตอบข้อความแสดงข้อผิดพลาดเมื่อมีข้อมูลที่ไม่ถูกต้อง.
error_titlestrหัวข้อของกล่องโต้ตอบข้อผิดพลาด (สูงสุด 32 ตัวอักษร).
error_messagestrเนื้อหาของกล่องโต้ตอบข้อผิดพลาด (สูงสุด 225 ตัวอักษร).
show_input_messageboolTrue เพื่อแสดงข้อความแจ้งเตือนการป้อนข้อมูลเมื่อเลือกเซลล์.
input_titlestrหัวข้อของการแจ้งเตือนการป้อนข้อมูล (สูงสุด 32 ตัวอักษร).
input_messagestrเนื้อหาของการแจ้งเตือนการป้อนข้อมูล (สูงสุด 255 ตัวอักษร).
allow_blankboolTrue เพื่ออนุญาตให้เซลล์ว่าง (ว่างเปล่า) โดยไม่ทำให้เกิดข้อผิดพลาด.
show_dropdownboolTrue เพื่อแสดงลูกศรดรอปดาวน์สำหรับการตรวจสอบรายการ.
ime_modeDataValidationImeModeโหมด 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 หากไม่มีใครใช้.

คุณสมบัติและการวนซ้ำ

PropertiesProperties
countจำนวนกฎการตรวจสอบในแผ่นงานนี้ (อ่านอย่างเดียว).
disable_promptsbool — ตั้งค่าเป็น 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")

ดูเพิ่มเติม

 ภาษาไทย