.NET에서 전환 필드 작업하는 방법

Step 1: 문서에서 전환 필드 찾기

Document.Range.Fields를 열거하고 각 필드의 Type ( FieldType 값) 을 관련 상수 — FieldBarcode, FieldDisplayBarcode, FieldMergeBarcode, FieldBidiOutline, FieldEQ, FieldFootnoteRef, 또는 FieldInfo — 와 비교한 다음, 일반 Field를 해당 클래스에 캐스팅하여 특정 속성에 접근합니다. 캐스팅하기 전에 항상 Type를 확인하세요: 잘못된 필드 클래스로 캐스팅하면 InvalidCastException가 발생합니다.

Step 2: DISPLAYBARCODE 또는 MERGEBARCODE 필드 구성

FieldDisplayBarcode(DISPLAYBARCODE 필드)와 FieldMergeBarcode(MERGEBARCODE 필드, 메일 병합을 위해 IMergeFieldSurrogate도 구현함)은 동일한 바코드 구성 속성 집합을 공유합니다: BarcodeType, BarcodeValue, SymbolHeight, SymbolRotation, ScalingFactor, ForegroundColor, BackgroundColor, PosCodeStyle, CaseCodeStyle, ErrorCorrectionLevel, DisplayText, AddStartStopChar, 및 FixCheckDigit. 필드 인스턴스에 이를 설정한 다음 Update()을 호출하여 문서를 저장하기 전에 Result가 새 구성을 반영하도록 하세요.

단계 3: 레거시 BARCODE(우편) 필드 데이터 읽기

FieldBarcode은 이전 BARCODE 필드를 구현하며, 이는 일반 목적 바코드가 아니라 미국 우편 바코드(POSTNET) 필드입니다 — Step 2에서의 BarcodeType/BarcodeValue 속성을 공유하지 않습니다. 대신 PostalAddress(바코드가 인코딩하는 주소), FacingIdentificationMark, IsUSPostalAddress, IsBookmark을 노출합니다. 이러한 속성을 읽기 전에 Field.Type을 FieldType.FieldBarcode와 특히 비교하십시오. DISPLAYBARCODE 또는 MERGEBARCODE 필드를 FieldBarcode로 캐스팅하면 기대하는 속성이 노출되지 않기 때문입니다.

단계 4: 사용자 지정 생성기로 바코드 이미지 렌더링

이 FOSS 에디션은 바코드 필드 데이터를 포함하지만 바코드 렌더링 엔진은 포함하지 않습니다. BarcodeParameters은 바코드 필드 계열 중 어느 쪽의 설정—Step 2의 DISPLAYBARCODE/MERGEBARCODE 속성 및 Step 3의 우편 속성—을 하나의 객체로 통합하여 렌더러에 전달하는 패스스루 컨테이너입니다. 실제 이미지 렌더링을 제공하려면 IBarcodeGenerator을 구현하고, GetBarcodeImage(parameters)와 레거시 GetOldBarcodeImage(parameters)를 노출하십시오; 구현이 제공되지 않으면 바코드 필드는 구성 데이터만 보유합니다.

단계 5: 레거시 호환성 필드 작업

레거시 .docx 파일에서 아직도 발견되는 오래된 필드 코드를 다루는 네 개의 다른 클래스가 있습니다. FieldBidiOutline은 오른쪽에서 왼쪽으로 개요 번호 매기기를 위한 BIDIOUTLINE 필드를 구현하며, 공통 Field 표면 외에는 속성을 노출하지 않습니다. FieldEQ는 EQ 방정식 필드를 구현하고 추가로 AsOfficeMath()을 노출하여 내용을 OfficeMath 객체로 변환합니다 — 이는 필드가 실제로 방정식을 인코딩한 경우에만 성공합니다. FieldFootnoteRef은 각주 또는 미주 표식을 교차 참조하는 FOOTNOTEREF 필드를 구현하며, 공통 Field 표면 외에는 속성을 노출하지 않습니다. FieldInfo은 INFO 필드를 구현하여, InfoType 및 NewValue 속성을 통해 문서 요약 정보 속성을 읽고 씁니다.

단계 6: 전환 필드 값 업데이트 또는 고정

모든 전환 필드 클래스는 GetFieldCode()(필드의 기본 코드 텍스트), Update()(결과를 다시 평가함), Unlink()(필드를 마지막으로 계산된 결과를 정적 텍스트로 교체함), Remove()(필드를 삭제함)를 상속합니다. 필드 구성을 변경한 후에는 Update()를 호출하여 Result가 변경을 반영하도록 하고, 필드의 현재 값을 재계산 가능하게 두지 않고 고정시켜야 할 경우에는 Unlink()을 사용하십시오.