DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss सेल रेंज में डेटा वैलिडेशन नियम जोड़ने का समर्थन करता है। वैलिडेशन नियमों का प्रबंधन किया जाता है ws.data_validations, एक DataValidationCollection प्रत्येक से जुड़ा हुआ Worksheet.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import (
    DataValidationType, DataValidationOperator,
    DataValidationAlertStyle, DataValidationImeMode,
    DataValidation, DataValidationCollection,
)

DataValidationType

DataValidationType एक है IntEnum लागू करने के लिए प्रतिबंध के प्रकार की पहचान करता है।.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0कोई वैलिडेशन प्रतिबंध नहीं।.
WHOLE_NUMBER1केवल पूर्णांक स्वीकार करता है।.
DECIMAL2दशमलव संख्याएँ स्वीकार करता है।.
LIST3ड्रॉपडाउन सूची से मान स्वीकार करता है।.
DATE4केवल तिथि मान स्वीकार करता है।.
TIME5केवल समय मान स्वीकार करता है।.
TEXT_LENGTH6पाठ की लंबाई द्वारा मान्य करता है।.
CUSTOM7कस्टम सूत्र का उपयोग करके मान्य करता है।.

DataValidationOperator

DataValidationOperator एक है IntEnum संख्यात्मक/तारीख/समय/लंबाई प्रतिबंधों के साथ उपयोग किए जाने वाले तुलना ऑपरेटर को निर्दिष्ट करता है।.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle एक है IntEnum नियंत्रित करता है कि जब अमान्य डेटा दर्ज किया जाता है तो Excel कैसे प्रतिक्रिया देता है।.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0एंट्री को अस्वीकार करता है और एक त्रुटि संवाद दिखाता है (डिफ़ॉल्ट)।.
WARNING1एक चेतावनी दिखाता है लेकिन एंट्री की अनुमति देता है।.
INFORMATION2एक सूचना संदेश दिखाता है लेकिन हमेशा एंट्री की अनुमति देता है।.

DataValidationImeMode

DataValidationImeMode एक है IntEnum पूर्वी एशियाई पाठ प्रविष्टि के लिए IME (इनपुट मेथड एडिटर) मोड को नियंत्रित करता है।.

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

DataValidation

एक DataValidation ऑब्जेक्ट एकल वैधता नियम और सेल रेंज (sqref).

ImageRenderOptions

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrइस नियम के लिए सेल रेंज (उदाहरण के लिए,., "B2:B100").
typeDataValidationTypeवैलिडेशन प्रकार (पूर्णांक, दशमलव, सूची, तिथि, समय, टेक्स्ट लंबाई, या कस्टम)।.
operatorDataValidationOperatorतुलना ऑपरेटर लागू किया गया formula1 (और formula2 के लिए BETWEEN/NOT_BETWEEN).
formula1strनिचली सीमा, सूची स्रोत (उदाहरण के लिए,., '"Apple,Banana,Cherry"'), या कस्टम फ़ॉर्मूला।.
formula2strऊपरी सीमा के लिए BETWEEN और NOT_BETWEEN ऑपरेटर।.
alert_styleDataValidationAlertStyleExcel अमान्य इनपुट पर कैसे प्रतिक्रिया देता है (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 मोड।.

ImageRenderOptions

कॉपी

validation.copy() -> DataValidation

इस वैलिडेशन नियम की एक डीप कॉपी लौटाता है।.


DataValidationCollection

DataValidationCollection को इस प्रकार एक्सेस किया जाता है ws.data_validations. यह एक वर्कशीट पर सभी मान्यकरण नियमों का प्रबंधन करता है।.

ImageRenderOptions

जोड़ें

ws.data_validations.add(
    sqref,
    validation_type=None,
    operator=None,
    formula1=None,
    formula2=None
) -> DataValidation

एक ही कॉल में नया मान्यकरण नियम बनाता और पंजीकृत करता है। बनाया गया लौटाता है DataValidation object.

add_validation

ws.data_validations.add_validation(validation: DataValidation) -> DataValidation

एक पूर्व-कॉन्फ़िगर किया गया पंजीकृत करता है DataValidation object. वही object लौटाता है।.

remove

ws.data_validations.remove(validation: DataValidation) -> bool

संदर्भ द्वारा एक validation rule हटाता है। लौटाता है True यदि नियम मिला और हटाया गया।.

remove_at

ws.data_validations.remove_at(index: int)

दिए गए शून्य-आधारित सूचकांक पर वैधता नियम को हटाता है।.

remove_by_range

ws.data_validations.remove_by_range(sqref: str) -> int

सभी validations को हटाता है जिनका sqref दिए गए रेंज के साथ ओवरलैप करता है। हटाए गए नियमों की संख्या लौटाता है।.

clear

ws.data_validations.clear()

वर्कशीट से सभी वैधता नियमों को हटाता है।.

get_validation

ws.data_validations.get_validation(cell_ref: str) -> DataValidation | None

दिए गए सेल रेफ़रेंस (जैसे, के लिए लागू validation rule लौटाता है., "B5"), या None यदि कोई लागू नहीं होता।.

गुणधर्म और पुनरावृत्ति

ImageRenderOptionsImageRenderOptions
countइस वर्कशीट पर validation rules की संख्या (केवल-पढ़ने योग्य)।.
disable_promptsbool — सेट करें True सभी input-message प्रॉम्प्ट्स को वैश्विक रूप से दबाने के लिए।.
__len__()ImageRenderOptions count.
__iter__()सभी पर इटररेट करता है DataValidation ऑब्जेक्ट्स।.
__getitem__(index)वापस देता है DataValidation शून्य‑आधारित पर index.

ImageRenderOptions

ड्रॉपडाउन सूची वैधता

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")

संबंधित देखें

 हिन्दी