Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss hücre aralıklarına veri doğrulama kuralları eklemeyi destekler. Doğrulama kuralları aracılığıyla yönetilir ws.data_validations, bir DataValidationCollection her birine eklenmiş Worksheet.

Enumerations: aspose.cells_foss

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

DataValidationType

DataValidationType bir IntEnum uygulanacak kısıtlama türünü tanımlayan.

EnumerationsEnumerationsEnumerations
NONE0Doğrulama kısıtlaması yok.
WHOLE_NUMBER1Yalnızca tam sayıları kabul eder.
DECIMAL2Ondalık sayıları kabul eder.
LIST3Açılır listeden değerleri kabul eder.
DATE4Yalnızca tarih değerlerini kabul eder.
TIME5Yalnızca zaman değerlerini kabul eder.
TEXT_LENGTH6Metin uzunluğuna göre doğrular.
CUSTOM7Özel bir formül kullanarak doğrular.

DataValidationOperator

DataValidationOperator bir IntEnum sayısal/tarih/zaman/uzunluk kısıtlamalarıyla kullanılan karşılaştırma operatörünü belirten.

EnumerationsEnumerations
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle bir IntEnum Geçersiz veri girildiğinde Excel’in nasıl tepki verdiğini kontrol etme.

EnumerationsEnumerationsEnumerations
STOP0Girişi reddeder ve bir hata iletişim kutusu gösterir (varsayılan).
WARNING1Bir uyarı gösterir ancak girişi kabul eder.
INFORMATION2Bilgilendirici bir mesaj gösterir ancak her zaman girişi kabul eder.

DataValidationImeMode

DataValidationImeMode bir IntEnum Doğu Asya metin girişi için IME (Input Method Editor) modunu kontrol eder.

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

DataValidation

Bir DataValidation nesne, tek bir doğrulama kuralını ve hücre aralığını tanımlar (sqref) uygulandığı.

Enumerations 

DataValidation(sqref=None)
EnumerationsEnumerationsEnumerations
sqref`strNone`

Enumerations

EnumerationsEnumerationsEnumerations
sqrefstrBu kural için hücre aralığı (örneğin,., "B2:B100").
typeDataValidationTypeDoğrulama türü (tam sayı, ondalık, liste, tarih, saat, metin uzunluğu veya özel).
operatorDataValidationOperatorUygulanan karşılaştırma operatörü formula1 (ve formula2 için BETWEEN/NOT_BETWEEN).
formula1strAlt sınır, liste kaynağı (örneğin,., '"Apple,Banana,Cherry"'), veya özel formül.
formula2strÜst sınır BETWEEN ve NOT_BETWEEN operatörler.
alert_styleDataValidationAlertStyleExcel’in geçersiz girdiye yanıtı (STOP, WARNING, veya INFORMATION).
show_error_messageboolTrue geçersiz girişte hata mesajı iletişim kutusunu görüntülemek için.
error_titlestrHata iletişim kutusunun başlığı (azami 32 karakter).
error_messagestrHata iletişim kutusunun gövdesi (azami 225 karakter).
show_input_messageboolTrue hücre seçildiğinde bir giriş istemi mesajı görüntülemek için.
input_titlestrGiriş isteminin başlığı (azami 32 karakter).
input_messagestrGiriş isteminin gövdesi (azami 255 karakter).
allow_blankboolTrue hata tetiklenmeden boş (boş) hücrelere izin vermek için.
show_dropdownboolTrue liste doğrulamalarında bir açılır ok göstermek için.
ime_modeDataValidationImeModeDoğu Asya metin girişi için IME modu.

Enumerations

copy 

validation.copy() -> DataValidation

Bu doğrulama kuralının derin bir kopyasını döndürür.

DataValidationCollection

DataValidationCollection şu şekilde erişilir: ws.data_validations. Çalışma sayfasındaki tüm doğrulama kurallarını yönetir.

Enumerations

add 

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

Tek bir çağrıda yeni bir doğrulama kuralı oluşturur ve kaydeder. Oluşturulanı döndürür DataValidation nesneyi.

add_validation 

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

Önceden yapılandırılmış bir DataValidation nesneyi. Aynı nesneyi döndürür.

remove 

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

Bir doğrulama kuralını referansla kaldırır. Döndürür True kural bulunup kaldırıldıysa.

remove_at 

ws.data_validations.remove_at(index: int)

Verilen sıfır tabanlı indeksteki doğrulama kuralını kaldırır.

remove_by_range 

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

Tüm doğrulamaları kaldırır, bunların sqref verilen aralıkla çakışır. Kaldırılan kural sayısını döndürür.

clear 

ws.data_validations.clear()

Çalışma sayfasındaki tüm doğrulama kurallarını kaldırır.

get_validation 

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

Verilen hücre referansına (örneğin,., "B5"), veya None eğer hiçbiri uygulanmaz.

Özellikler ve Yineleme

EnumerationsEnumerations
countBu çalışma sayfasındaki doğrulama kurallarının sayısı (yalnızca okunabilir).
disable_promptsbool — Şu değere ayarla True tüm giriş mesajı istemlerini küresel olarak bastırmak için.
__len__()Enumerations count.
__iter__()Tümü üzerinde yineleme yapar DataValidation nesneler.
__getitem__(index)Şunu döndürür DataValidation sıfır tabanlı index.

Enumerations

Açılır Liste Doğrulaması 

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

Sayısal Aralık Doğrulaması 

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

Ayrıca Bakınız

 Türkçe