DataValidation — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss از افزودن قوانین اعتبارسنجی داده به بازههای سلول پشتیبانی میکند. قوانین اعتبارسنجی از طریق ws.data_validations,، یک DataValidationCollection متصل به هر Worksheet.
ColladaSaveOptions: aspose.cells_foss
from aspose.cells_foss import (
DataValidationType, DataValidationOperator,
DataValidationAlertStyle, DataValidationImeMode,
DataValidation, DataValidationCollection,
)DataValidationType
DataValidationType یک IntEnum که نوع محدودیتی که باید اعمال شود را شناسایی میکند.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
NONE | 0 | بدون محدودیت اعتبارسنجی. |
WHOLE_NUMBER | 1 | فقط اعداد صحیح را میپذیرد. |
DECIMAL | 2 | اعداد اعشاری را میپذیرد. |
LIST | 3 | مقادیر را از فهرست کشویی میپذیرد. |
DATE | 4 | فقط مقادیر تاریخ را میپذیرد. |
TIME | 5 | فقط مقادیر زمان را میپذیرد. |
TEXT_LENGTH | 6 | بر اساس طول متن اعتبارسنجی میکند. |
CUSTOM | 7 | با استفاده از فرمول سفارشی اعتبارسنجی میکند. |
DataValidationOperator
DataValidationOperator یک IntEnum عملگر مقایسهای که با محدودیتهای عددی/تاریخی/زمانی/طول استفاده میشود را مشخص میکند.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
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 کنترل میکند که اکسل هنگام وارد کردن دادههای نامعتبر چگونه واکنش نشان دهد.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
STOP | 0 | ورودی را رد میکند و یک دیالوگ خطا نمایش میدهد (پیشفرض). |
WARNING | 1 | هشدار نشان میدهد اما اجازه ورود را میدهد. |
INFORMATION | 2 | پیام اطلاعاتی نمایش میدهد اما همیشه اجازه ورود را میدهد. |
DataValidationImeMode
DataValidationImeMode یک است IntEnum کنترل حالت IME (Input Method Editor) برای ورود متنهای آسیای شرقی.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
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
یک DataValidation شیء یک قانون اعتبارسنجی تک را توصیف میکند و بازه سلولی (sqref).
ColladaSaveOptions
DataValidation(sqref=None)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
sqref | `str | None` |
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
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 | عنوان دیالوگ خطا (حداکثر ۳۲ کاراکتر). |
error_message | str | متن بدنه دیالوگ خطا (حداکثر ۲۲۵ کاراکتر). |
show_input_message | bool | True برای نمایش پیام درخواست ورودی هنگام انتخاب سلول. |
input_title | str | عنوان درخواست ورودی (حداکثر ۳۲ کاراکتر). |
input_message | str | متن بدنه درخواست ورودی (حداکثر ۲۵۵ کاراکتر). |
allow_blank | bool | True برای اجازه دادن به سلولهای خالی (بدون مقدار) بدون ایجاد خطا. |
show_dropdown | bool | True برای نمایش فلش کشویی برای اعتبارسنجیهای لیست. |
ime_mode | DataValidationImeMode | حالت IME برای ورودی متن شرق آسیا. |
ColladaSaveOptions
کپی
validation.copy() -> DataValidationیک کپی عمیق از این قانون اعتبارسنجی را برمیگرداند.
DataValidationCollection
DataValidationCollection به عنوان دسترسی میشود. ws.data_validations. این تمام قوانین اعتبارسنجی را در یک برگه کاری مدیریت میکند.
ColladaSaveOptions
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 شیء. همان شیء را برمیگرداند.
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 اگر هیچکدام اعمال نشود.
ویژگیها و تکرار
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
count | تعداد قوانین اعتبارسنجی در این برگه کاری (فقط‑خواندنی). |
disable_prompts | bool — تنظیم به True برای سرکوب تمام پیامهای ورودی بهصورت سراسری. |
__len__() | ColladaSaveOptions count. |
__iter__() | بر روی همه تکرار میکند DataValidation اشیاء. |
__getitem__(index) | باز میگرداند DataValidation با ایندکس صفر مبنا index. |
ColladaSaveOptions
اعتبارسنجی لیست کشویی
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")