Cells
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss는 셀 범위에 데이터 유효성 검사 규칙을 추가하는 것을 지원합니다. 유효성 검사 규칙은 ws.data_validations, a 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 객체를 반환합니다.

add_validation 

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

미리 구성된 DataValidation 객체를 등록합니다. 동일한 객체를 반환합니다.

제거 

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

참조를 통해 검증 규칙을 제거합니다. 반환합니다 True 규칙이 발견되어 제거된 경우.

remove_at 

ws.data_validations.remove_at(index: int)

주어진 0부터 시작하는 인덱스에 있는 검증 규칙을 제거합니다.

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 적용되는 것이 없을 경우.

속성 및 반복

ImageRenderOptionsImageRenderOptions
count이 워크시트의 검증 규칙 수 (읽기 전용).
disable_promptsbool — 설정값 True 전역적으로 모든 입력 메시지 프롬프트를 억제합니다.
__len__()ImageRenderOptions count.
__iter__()모든 항목을 반복합니다 DataValidation 객체들.
__getitem__(index)반환합니다 DataValidation 0 기반에서 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")

참고

 한국어