DataValidation — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss hỗ trợ thêm các quy tắc xác thực dữ liệu vào các phạm vi ô. Các quy tắc xác thực được quản lý thông qua ws.data_validations, một DataValidationCollection được đính kèm vào mỗi Worksheet.
Enumerations: aspose.cells_foss
from aspose.cells_foss import (
DataValidationType, DataValidationOperator,
DataValidationAlertStyle, DataValidationImeMode,
DataValidation, DataValidationCollection,
)DataValidationType
DataValidationType là một IntEnum xác định loại ràng buộc sẽ áp dụng.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
NONE | 0 | Không có ràng buộc xác thực. |
WHOLE_NUMBER | 1 | Chỉ chấp nhận số nguyên. |
DECIMAL | 2 | Chấp nhận số thập phân. |
LIST | 3 | Chấp nhận các giá trị từ danh sách thả xuống. |
DATE | 4 | Chỉ chấp nhận giá trị ngày. |
TIME | 5 | Chỉ chấp nhận giá trị thời gian. |
TEXT_LENGTH | 6 | Xác thực dựa trên độ dài văn bản. |
CUSTOM | 7 | Xác thực bằng công thức tùy chỉnh. |
DataValidationOperator
DataValidationOperator là một IntEnum xác định toán tử so sánh được sử dụng với các ràng buộc số/ngày/giờ/độ dài.
| Enumerations | Enumerations |
|---|---|
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 là một IntEnum kiểm soát cách Excel phản hồi khi dữ liệu không hợp lệ được nhập vào.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
STOP | 0 | Từ chối mục nhập và hiển thị hộp thoại lỗi (mặc định). |
WARNING | 1 | Hiển thị cảnh báo nhưng vẫn cho phép nhập. |
INFORMATION | 2 | Hiển thị thông báo thông tin nhưng luôn cho phép nhập. |
DataValidationImeMode
DataValidationImeMode là một IntEnum điều khiển chế độ IME (Input Method Editor) cho việc nhập văn bản Đông Á.
| Enumerations | Enumerations |
|---|---|
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
Một DataValidation đối tượng mô tả một quy tắc xác thực duy nhất và phạm vi ô (sqref) mà nó áp dụng.
Enumerations
DataValidation(sqref=None)| Enumerations | Enumerations | Enumerations |
|---|---|---|
sqref | `str | None` |
Enumerations
| Enumerations | Enumerations | Enumerations |
|---|---|---|
sqref | str | Phạm vi ô cho quy tắc này (ví dụ,., "B2:B100"). |
type | DataValidationType | Kiểu xác thực (số nguyên, số thập phân, danh sách, ngày, thời gian, độ dài văn bản, hoặc tùy chỉnh). |
operator | DataValidationOperator | Toán tử so sánh được áp dụng cho formula1 (và formula2 cho BETWEEN/NOT_BETWEEN). |
formula1 | str | Giới hạn dưới, nguồn danh sách (ví dụ,., '"Apple,Banana,Cherry"'), hoặc công thức tùy chỉnh. |
formula2 | str | Giới hạn trên cho BETWEEN và NOT_BETWEEN các toán tử. |
alert_style | DataValidationAlertStyle | Cách Excel phản hồi khi nhập không hợp lệ (STOP, WARNING, hoặc INFORMATION). |
show_error_message | bool | True để hiển thị hộp thoại thông báo lỗi khi nhập không hợp lệ. |
error_title | str | Tiêu đề của hộp thoại lỗi (tối đa 32 ký tự). |
error_message | str | Nội dung của hộp thoại lỗi (tối đa 225 ký tự). |
show_input_message | bool | True để hiển thị thông báo nhắc nhập khi ô được chọn. |
input_title | str | Tiêu đề của lời nhắc nhập (tối đa 32 ký tự). |
input_message | str | Nội dung của lời nhắc nhập (tối đa 255 ký tự). |
allow_blank | bool | True để cho phép các ô trống (rỗng) mà không kích hoạt lỗi. |
show_dropdown | bool | True để hiển thị mũi tên thả xuống cho việc xác thực danh sách. |
ime_mode | DataValidationImeMode | Chế độ IME cho việc nhập văn bản Đông Á. |
Enumerations
copy
validation.copy() -> DataValidationTrả về một bản sao sâu của quy tắc xác thực này.
DataValidationCollection
DataValidationCollection được truy cập như ws.data_validations. Nó quản lý tất cả các quy tắc xác thực trên một bảng tính.
Enumerations
add
ws.data_validations.add(
sqref,
validation_type=None,
operator=None,
formula1=None,
formula2=None
) -> DataValidationTạo và đăng ký một quy tắc xác thực mới trong một lần gọi. Trả về đối tượng đã tạo DataValidation đối tượng.
add_validation
ws.data_validations.add_validation(validation: DataValidation) -> DataValidationĐăng ký một cấu hình đã được cấu hình sẵn DataValidation đối tượng. Trả về cùng một đối tượng.
remove
ws.data_validations.remove(validation: DataValidation) -> boolXóa một quy tắc xác thực theo tham chiếu. Trả về True nếu quy tắc được tìm thấy và đã xóa.
remove_at
ws.data_validations.remove_at(index: int)Xóa quy tắc xác thực tại chỉ mục bắt đầu từ 0 được chỉ định.
remove_by_range
ws.data_validations.remove_by_range(sqref: str) -> intXóa tất cả các xác thực mà sqref giao với phạm vi đã cho. Trả về số lượng quy tắc đã xóa.
clear
ws.data_validations.clear()Xóa tất cả các quy tắc xác thực khỏi bảng tính.
get_validation
ws.data_validations.get_validation(cell_ref: str) -> DataValidation | NoneTrả về quy tắc xác thực áp dụng cho tham chiếu ô đã cho (ví dụ,., "B5"), hoặc None nếu không có quy tắc nào áp dụng.
Thuộc tính và Lặp lại
| Enumerations | Enumerations |
|---|---|
count | Số lượng quy tắc xác thực trên bảng tính này (chỉ đọc). |
disable_prompts | bool — Đặt thành True để tắt toàn bộ thông báo nhập liệu trên toàn cầu. |
__len__() | Enumerations count. |
__iter__() | Lặp lại qua tất cả DataValidation đối tượng. |
__getitem__(index) | Trả về DataValidation tại chỉ số bắt đầu từ 0 index. |
Enumerations
Xác thực danh sách thả xuống
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")Xác thực phạm vi số
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")