본문으로 건너뛰기

IWriteData

검증 기능을 지원하는 항목에 데이터를 쓰기 위한 인터페이스입니다.

네임스페이스: ControlBee.Interfaces

메서드​

WriteData​

선택적 범위 검증을 사용하여 항목 위치에 데이터를 씁니다.

void WriteData(ItemDataWriteArgs args);

매개변수:

  • args — 쓰기 작업 세부 정보를 포함하는 ItemDataWriteArgs 객체입니다.

ItemDataWriteArgs​

데이터 쓰기 작업 매개변수를 캡슐화하는 클래스입니다.

속성:

  • Location (object[]) — 데이터 항목의 계층적 위치 경로입니다.
  • NewValue (object) — 쓸 새 값입니다.
  • MinValue (double?) — 검증을 위한 선택적 최소값 제약 조건입니다.
  • MaxValue (double?) — 검증을 위한 선택적 최대값 제약 조건입니다.

메서드:

  • EnsureNewValueInRange() — 새 값이 지정된 최소/최대 범위 내에 있는지 검증합니다. 검증 실패 시 ValueError를 발생시킵니다.

사용 예시​

IWriteData writer = ...;

// 범위 검증을 사용하여 값 쓰기
var args = new ItemDataWriteArgs
{
    Location = new object[] { "Motor", "Speed" },
    NewValue = 1500.0,
    MinValue = 0.0,
    MaxValue = 3000.0
};

// 쓰기 전 검증
args.EnsureNewValueInRange();

// 데이터 쓰기
writer.WriteData(args);

예외​

  • ValueError — 새 값이 지정된 범위를 벗어났을 때 EnsureNewValueInRange()에서 발생합니다.

참고​