FieldBuilder를 사용한 필드 구축

FieldBuilder을(를) 사용하여 필드 만들기

이 가이드는 Aspose.Words FOSS에서 .NET용 Word 필드를 처음부터 구축하는 방법을 보여줍니다 using FieldBuilder and FieldArgumentBuilder, 문서에 이미 존재하는 필드와 작업하는 대신에. 기존 필드를 읽기, 업데이트 또는 제거하려면, 다음을 참조하십시오. 필드 작업 가이드.

FieldBuilder으로 필드 만들기

FieldBuilder은(는) 필드 코드 토큰(인수와 스위치)으로부터 필드를 생성합니다. new FieldBuilder(fieldType)을(를) 사용해 원하는 필드의 FieldType을(를) 전달하여 생성합니다. 인수는 오버로드된 AddArgument(argument) 메서드로 추가할 수 있으며, 이 메서드는 string, int, double, 중첩된 FieldBuilder, 또는 FieldArgumentBuilder을(를) 받아들입니다. 스위치는 오버로드된 AddSwitch(switchName), AddSwitch(switchName, switchArgument)(string), 또는 AddSwitch(switchName, switchArgument)(int/double) 메서드로 추가합니다.

구축된 필드 삽입

FieldBuilder에 인수와 스위치가 모두 설정되면, BuildAndInsert(refNode)을 호출하여 문서에 삽입합니다 — 하나의 오버로드는 Inline 노드를 받아 그 앞에 필드를 삽입하고, 다른 오버로드는 Paragraph을 받아 해당 단락의 끝에 필드를 삽입합니다.

FieldArgumentBuilder을(를) 사용하여 복합 인수 구성

FieldArgumentBuilder은(는) 필드, 노드, 일반 텍스트로 구성된 복합 필드 인수를 생성합니다. 단일 인수가 단순 문자열보다 더 필요할 때 사용합니다. new FieldArgumentBuilder()으로 하나를 만들고, AddText(text)를 호출하여 일반 텍스트를 추가하고, AddNode(node)를 호출하여 Inline 노드를 추가하거나, AddField(fieldBuilder)를 사용하여 다른 필드(자신만의 FieldBuilder으로 구축)를 인수 안에 중첩합니다. 완성된 FieldArgumentBuilder을 FieldBuilder.AddArgument(argument)에 전달하여 외부 필드의 인수 중 하나로 사용합니다.

팁 및 모범 사례

• FieldBuilder은(는) 전용 필드 클래스 중 하나(FieldDate 또는 FieldSymbol 등)로 지원되지 않는 필드 유형을 구성할 때, 또는 데이터를 기반으로 필드 코드를 프로그래밍 방식으로 생성하고 수동으로 작성하지 않을 때 사용합니다.
• 간단한 경우에는 FieldBuilder.AddArgument(FieldBuilder)을 사용하여 외부 필드 인수 안에 자식 필드를 중첩하고, 인수가 단일 필드 이상일 때는 FieldArgumentBuilder을 사용하여 텍스트, 노드 및 중첩 필드가 혼합된 인수를 구축합니다.
• 필드가 위치해야 할 위치에 맞는 BuildAndInsert(refNode) 오버로드를 선택하세요 — 특정 Inline 노드 앞이나 Paragraph 끝에.
• BuildAndInsert 후에는 결과를 트리의 다른 필드와 동일하게 취급합니다 — 예를 들어, 필드 유형에 명시적 재계산이 필요하면 Update()을 호출합니다.

일반적인 문제

FAQ

언제 FieldBuilder을 사용하고 미리 만든 필드 코드를 삽입하는 대신에 사용해야 하나요?

프로그래밍 방식으로 필드를 구성하면서 필드의 인수와 스위치를 명시적으로 제어해야 할 경우, 미리 만든 필드 코드 문자열을 삽입하는 대신 FieldBuilder을 사용하십시오.

필드에 하나 이상의 인수를 어떻게 추가합니까?

AddArgument을 인수당 한 번 호출하십시오 — string, int, double, 중첩된 FieldBuilder, 그리고 FieldArgumentBuilder에 대해 오버로드됩니다.

인수에 텍스트와 다른 필드가 혼합된 필드를 만들 수 있나요?

예 — 필요에 따라 AddText, AddNode, AddField을 호출하면서 FieldArgumentBuilder을 사용하고, 그런 다음 FieldBuilder.AddArgument에 전달하십시오.

구축한 필드를 실제로 문서에 어떻게 넣나요?

BuildAndInsert(refNode)을 호출하고, Inline 노드(그 앞에 삽입) 또는 Paragraph(그 끝에 삽입) 중 하나를 전달하십시오.

API Reference 요약

참조

• Aspose.Words for .NET — Enterprise Documentation