DataValidation

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 که نوع محدودیتی که باید اعمال شود را شناسایی می‌کند.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
NONE0بدون محدودیت اعتبارسنجی.
WHOLE_NUMBER1فقط اعداد صحیح را می‌پذیرد.
DECIMAL2اعداد اعشاری را می‌پذیرد.
LIST3مقادیر را از فهرست کشویی می‌پذیرد.
DATE4فقط مقادیر تاریخ را می‌پذیرد.
TIME5فقط مقادیر زمان را می‌پذیرد.
TEXT_LENGTH6بر اساس طول متن اعتبارسنجی می‌کند.
CUSTOM7با استفاده از فرمول سفارشی اعتبارسنجی می‌کند.

DataValidationOperator

DataValidationOperator یک IntEnum عملگر مقایسه‌ای که با محدودیت‌های عددی/تاریخی/زمانی/طول استفاده می‌شود را مشخص می‌کند.

ColladaSaveOptionsColladaSaveOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle یک IntEnum کنترل می‌کند که اکسل هنگام وارد کردن داده‌های نامعتبر چگونه واکنش نشان دهد.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
STOP0ورودی را رد می‌کند و یک دیالوگ خطا نمایش می‌دهد (پیش‌فرض).
WARNING1هشدار نشان می‌دهد اما اجازه ورود را می‌دهد.
INFORMATION2پیام اطلاعاتی نمایش می‌دهد اما همیشه اجازه ورود را می‌دهد.

DataValidationImeMode

DataValidationImeMode یک است IntEnum کنترل حالت IME (Input Method Editor) برای ورود متن‌های آسیای شرقی.

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

DataValidation

یک DataValidation شیء یک قانون اعتبارسنجی تک را توصیف می‌کند و بازه سلولی (sqref).

ColladaSaveOptions

DataValidation(sqref=None)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqref`strNone`

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqrefstrبازه سلولی برای این قانون (مثلاً،., "B2:B100").
typeDataValidationTypeنوع اعتبارسنجی (عدد صحیح، اعشاری، فهرست، تاریخ، زمان، طول متن یا سفارشی).
operatorDataValidationOperatorعملگر مقایسه‌ای اعمال شده به formula1formula2 برای BETWEEN/NOT_BETWEEN).
formula1strحد پایین، منبع فهرست (مثلاً،., '"Apple,Banana,Cherry"'), یا فرمول سفارشی.
formula2strحد بالایی برای BETWEEN و NOT_BETWEEN عملگرها.
alert_styleDataValidationAlertStyleنحوهٔ واکنش Excel به ورودی نامعتبر (STOP, WARNING,، یا INFORMATION).
show_error_messageboolTrue برای نمایش دیالوگ پیام خطا در ورودی نامعتبر.
error_titlestrعنوان دیالوگ خطا (حداکثر ۳۲ کاراکتر).
error_messagestrمتن بدنه دیالوگ خطا (حداکثر ۲۲۵ کاراکتر).
show_input_messageboolTrue برای نمایش پیام درخواست ورودی هنگام انتخاب سلول.
input_titlestrعنوان درخواست ورودی (حداکثر ۳۲ کاراکتر).
input_messagestrمتن بدنه درخواست ورودی (حداکثر ۲۵۵ کاراکتر).
allow_blankboolTrue برای اجازه دادن به سلول‌های خالی (بدون مقدار) بدون ایجاد خطا.
show_dropdownboolTrue برای نمایش فلش کشویی برای اعتبارسنجی‌های لیست.
ime_modeDataValidationImeModeحالت 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 اگر هیچ‌کدام اعمال نشود.

ویژگی‌ها و تکرار

ColladaSaveOptionsColladaSaveOptions
countتعداد قوانین اعتبارسنجی در این برگه کاری (فقط‑خواندنی).
disable_promptsbool — تنظیم به 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")

همچنین ببینید

 فارسی