문서 자동화 필드 (IF, COMPARE, MACROBUTTON, 및 기타)
문서 자동화 필드 (IF, COMPARE 및 기타)
이 가이드는 Word의 문서 자동화 필드 패밀리를 사용하여 작업하는 방법을 보여줍니다 in Aspose.Words FOSS용 .NET – 조건부 텍스트를 제어하고, 문서 범위 변수를 저장하며, 매크로, 탐색 및 인쇄 동작을 연결하는 필드로, 단순히 계산된 값을 표시하는 것이 아닙니다. 각각은 a Field 하위 클래스는 Aspose.Words.Fields 네임스페이스: FieldIf, FieldCompare, FieldDocVariable, FieldGoToButton, FieldMacroButton, 그리고 FieldPrint. 이들은 모두 핵심 Field 멤버는 다음에 설명된 대로 필드 작업 – GetFieldCode(), Update(), Remove(), Unlink(), Start/Separator/End, Result, 및 Format – 이 페이지에서는 각각에 대한 구체적인 내용을 다룹니다.
조건부 텍스트 (FieldIf 사용)
FieldIf 구현합니다 IF 필드. LeftExpression, ComparisonOperator, 및 RightExpression 조건을 설명합니다 – 동일한 3부분 형태를 사용하여 IComparisonExpressionEvaluator (참조 필드 작업) – 및 TrueText / FalseText 두 가지 가능한 결과를 보유합니다. 호출 EvaluateCondition() 조건을 직접 평가합니다; 반환값은 FieldIfComparisonResult 값: True, False, 또는 Error.
값 비교 (FieldCompare 사용)
FieldCompare은 COMPARE 필드를 구현합니다. FieldIf와 유사하게, 비교를 설명하기 위해 LeftExpression, ComparisonOperator, 및 RightExpression를 노출하지만, 두 텍스트 대안을 전환하는 대신 부울 스타일의 결과를 생성합니다.
문서 변수 (FieldDocVariable 사용)
FieldDocVariable은 DOCVARIABLE 필드를 구현하고, 해당 VariableName 속성을 통해 이름이 지정된 문서 범위 변수를 읽습니다.
버튼: FieldGoToButton 및 FieldMacroButton
FieldGoToButton은 GOTOBUTTON 필드를 구현합니다: Location는 이동할 북마크, 페이지 또는 기타 대상의 이름을 지정하고, DisplayText는 문서에 표시되는 레이블입니다. FieldMacroButton는 MACROBUTTON 필드를 구현합니다: MacroName은 실행할 매크로의 이름을 지정하고, DisplayText는 레이블입니다. FieldIf와 FieldMacroButton는 또한 IMergeFieldSurrogate을 구현하는데, 이는 Word의 메일 병합 인식 필드가 자신을 교체 가능한 콘텐츠로 표시하기 위해 사용하는 인터페이스입니다.
FieldPrint와(과) 인쇄 지침
FieldPrint은 PRINT 필드를 구현합니다: PrinterInstructions와 PostScriptGroup는 문서에 직접 삽입된 프린터 전용 지시문을 보관합니다.
팁 및 모범 사례
FieldIf.EvaluateCondition()을(를) 사용하여 조건 결과(FieldIfComparisonResult)를 직접TrueText/FalseText을(를) 파싱할 필요 없이 읽을 수 있습니다.FieldCompare와FieldIf은 동일한LeftExpression/ComparisonOperator/RightExpression형태를 공유합니다 – 하나의 비교 표현식을 생성하거나 검사하는 코드를 두 필드 유형 모두에 재사용할 수 있습니다.- 이것들은 모두임을 기억하십시오
Field하위 클래스:GetFieldCode(),Update(),Remove(), 그리고Unlink()from 필드 작업 여기에서도 정확히 동일한 방식으로 적용됩니다.
일반적인 문제
| 문제 | 원인 | 수정 |
|---|---|---|
FieldIf.EvaluateCondition()은 Error을 반환합니다 | 조건의 피연산자나 연산자를 그대로 평가할 수 없습니다 | 유효한 값을 위해 LeftExpression, ComparisonOperator, 및 RightExpression를 확인하십시오 |
FieldDocVariable 결과가 기대한 변수 값을 반영하지 않습니다 | VariableName은(는) 문서에 실제로 존재하는 변수 이름과 일치하지 않습니다 | 읽기 전에 정확한 변수 이름과 해당 변수가 존재하는지 확인하십시오 Result |
FieldGoToButton/FieldMacroButton 표시 텍스트가 Word에 표시되는 내용과 일치하지 않습니다 | DisplayText이(가) 필드가 업데이트되기 전에 읽혔거나, 일치하는 Update() 호출 없이 설정되었습니다 | 필드에 대해 Update()을(를) 호출하거나, 변경 후에 DisplayText을(를) 다시 읽으십시오 |
FAQ
조건부 IF 필드의 결과를 어떻게 읽나요?
원시 FieldIfComparisonResult을(를) 얻으려면 FieldIf.EvaluateCondition()을 호출하고, 필드가 전환하는 두 개의 문자 그대로 텍스트 대안을 읽으려면 TrueText / FalseText을 읽으세요.
FieldIf와 FieldCompare의 차이점은 무엇인가요?
FieldIf (the IF field) 는 조건에 따라 TrueText와 FalseText 사이를 전환합니다. FieldCompare (the COMPARE field) 는 동일한 비교 형태를 가지고 있지만 대체 텍스트 대신 불리언 스타일의 결과를 생성합니다.
DOCVARIABLE 필드에서 문서 변수의 이름을 어떻게 읽을 수 있나요?
읽으세요 FieldDocVariable.VariableName.
GOTOBUTTON 필드의 목적지를 어떻게 찾나요?
읽으세요 FieldGoToButton.Location; DisplayText은(는) 문서에 표시된 버튼의 레이블을 제공합니다.
API Reference 요약
| 클래스 / 열거형 | 설명 |
|---|---|
FieldIf | IF 필드; LeftExpression, ComparisonOperator, RightExpression, TrueText, FalseText, EvaluateCondition() |
FieldIfComparisonResult | FieldIf.EvaluateCondition()의 Enum 결과: True, False, Error |
FieldCompare | COMPARE 필드; LeftExpression, ComparisonOperator, RightExpression |
FieldDocVariable | DOCVARIABLE 필드; VariableName |
FieldGoToButton | GOTOBUTTON 필드; Location, DisplayText |
FieldMacroButton | MACROBUTTON 필드; MacroName, DisplayText |
FieldPrint | PRINT 필드; PrinterInstructions, PostScriptGroup |
