NodeImporter를 사용한 노드 가져오기

NodeImporter을(를) 사용한 노드 가져오기

이 가이드는 두 개의 서로 다른 Document Aspose.Words FOSS에서 .NET용 인스턴스를 전용 NodeImporter 클래스와 세분화된 ImportFormatOptions, 기본적인 것 이상으로 많은 노드를 효율적으로 가져오거나 가져오기 동작을 제어해야 하는 시나리오에 대해 ImportFormatMode 선택. 더 간단한 Document.ImportNode, Document.AppendDocument, 및 DocumentBuilder.InsertDocument 편리한 메서드, 자세한 내용은 문서 작업 가이드.

NodeImporter: 반복 설정 없이 반복 가져오기

NodeImporter은(는) 한 문서에서 다른 문서로 노드를 반복적으로 가져오도록 설계되어, 단일 사용 가져오기마다 발생하는 호출당 설정 비용을 피합니다. new NodeImporter(srcDoc, dstDoc, importFormatMode)을 사용해 하나 생성하거나 — 보다 정밀한 제어를 위해 new NodeImporter(srcDoc, dstDoc, importFormatMode, importFormatOptions) 오버로드를 사용해 — 한 번만 만들고, 가져와야 할 각 노드마다 동일한 인스턴스에서 ImportNode(srcNode, isImportChildren)을 호출합니다. 여러 호출에 걸쳐 하나의 NodeImporter 인스턴스를 재사용하면 매 호출마다 발생하는 편의 가져오기 설정 비용을 줄일 수 있습니다.

ImportFormatOptions을 이용한 정밀 가져오기 제어

ImportFormatOptions은(는) 기본 ImportFormatMode 선택(UseDestinationStyles, KeepSourceFormatting, KeepDifferentStyles)에 보다 세밀한 스위치를 추가합니다: SmartStyleBehavior (bool)는 소스와 대상에 동일한 이름을 가진 스타일이 어떻게 가져와지는지를 제어합니다. KeepSourceNumbering (bool)는 소스와 대상 간에 번호 매김이 충돌할 때 번호 매김이 어떻게 가져와지는지를 제어합니다. IgnoreTextBoxes 및 IgnoreHeaderFooter (bool)은 KeepSourceFormatting이 적용될 때 텍스트 박스와 머리글/바닥글 콘텐츠에 대한 소스 서식을 각각 억제합니다. MergePastedLists (bool)는 붙여넣은 목록을 주변 목록과 병합하여 별도로 유지하지 않습니다. ForceCopyStyles (bool)는 KeepSourceFormatting 모드에서 대상 버전을 재사용하는 대신 충돌하는 스타일을 복사합니다. AdjustSentenceAndWordSpacing (bool)는 자동으로 간격을 조정합니다. AppendDocumentWithNewPage (bool)는 첫 번째 가져온 섹션의 유형을 NewPage로 강제합니다.

팁 및 모범 사례

• 많은 노드를 가져올 때 단일 NodeImporter 인스턴스를 생성하고 ImportNode 호출 루프에서 재사용하십시오 — 노드당 새로운 임포터를 만들면 설정 작업이 불필요하게 반복됩니다.
• 단순 ImportFormatMode 선택만으로는 충분히 정확하지 않을 때 ImportFormatOptions 인스턴스를 NodeImporter 생성자 오버로드에 전달하십시오 — 예를 들어, 전체적으로 KeepSourceFormatting를 사용하면서도 KeepSourceNumbering으로 소스 리스트 번호를 유지하고 싶을 때.
• KeepSourceFormatting가 해당 콘텐츠 유형에 대해 원하지 않는 과도한 소스 스타일링을 가져올 경우 IgnoreTextBoxes 또는 IgnoreHeaderFooter을 설정하십시오.
• NodeImporter.ImportNode(srcNode, isImportChildren)는 서명과 동작 면에서 문서 수준의 import 호출을 그대로 반영합니다; 차이점은 재사용 효율성이지 import 의미론이 아닙니다.

일반적인 문제

FAQ

단일 import 호출 대신 NodeImporter를 사용해야 하는 경우는 언제인가요?

루프에서 많은 노드를 가져올 때 — 각 호출마다 설정 비용을 지불하는 대신 미리 하나의 NodeImporter를 구성하고 ImportNode을 반복적으로 호출하십시오.

ImportFormatOptions은 ImportFormatMode보다 무엇을 추가합니까?

기본 ImportFormatMode 선택 위에 겹쳐지는 SmartStyleBehavior, KeepSourceNumbering, IgnoreTextBoxes, IgnoreHeaderFooter, MergePastedLists, ForceCopyStyles, AdjustSentenceAndWordSpacing, AppendDocumentWithNewPage와 같은 세밀한 스위치들.

NodeImporter.ImportNode은 문서 수준에서 가져오는 것과 동작이 다릅니까?

아니요 — 두 경우 모두 소스 노드와 isImportChildren 플래그를 받아 대상 문서에 가져옵니다; NodeImporter은 설정을 한 번만 수행하고 여러 호출에 재사용할 수 있도록 존재합니다.

가져올 때 원본 문서의 목록 번호를 그대로 유지하려면 어떻게 해야 하나요?

KeepSourceNumbering가 true인 ImportFormatOptions으로 NodeImporter을 구성하십시오.

API Reference 요약

참조

• Aspose.Words for .NET — Enterprise Documentation