구조화된 문서 태그 범위 시작 XML 매핑

소개

Word 문서에 동적으로 XML 데이터를 삽입하고 싶었던 적이 있나요? 글쎄요, 운이 좋으시네요! Aspose.Words for .NET이 이 작업을 아주 쉽게 해줍니다. 이 튜토리얼에서는 구조화된 문서 태그 범위 시작 XML 매핑에 대해 자세히 알아보겠습니다. 이 기능을 사용하면 사용자 지정 XML 부분을 콘텐츠 컨트롤에 바인딩하여 문서 콘텐츠가 XML 데이터와 원활하게 업데이트되도록 할 수 있습니다. 문서를 동적인 걸작으로 바꿀 준비가 되었습니다.

필수 조건

코딩 부분으로 넘어가기 전에 먼저 필요한 모든 것이 있는지 확인해 보겠습니다.

Aspose.Words for .NET 라이브러리: 최신 버전이 있는지 확인하세요. 다운로드할 수 있습니다.여기.
개발 환경: Visual Studio 또는 C#을 지원하는 다른 IDE.
C#에 대한 기본 지식: C# 프로그래밍에 대한 지식이 필수입니다.
Word 문서: 작업할 수 있는 샘플 Word 문서입니다.

네임스페이스 가져오기

우선, 필요한 네임스페이스를 임포트해 보겠습니다. 이렇게 하면 Aspose.Words for .NET에서 필요한 모든 클래스와 메서드에 액세스할 수 있습니다.

using System;
using Aspose.Words;
using Aspose.Words.Markup;
using System.Text;

1단계: 문서 디렉토리 설정

모든 프로젝트에는 기초가 필요하죠? 여기서 우리는 문서 디렉토리로 가는 경로를 설정합니다.

// 문서 디렉토리 경로
string dataDir = "YOUR DOCUMENT DIRECTORY";

2단계: Word 문서 로드

다음으로 Word 문서를 로드합니다. 이 문서에 XML 데이터를 삽입할 것입니다.

Document doc = new Document(dataDir + "Multi-section structured document tags.docx");

3단계: 사용자 정의 XML 부분 추가

삽입하려는 데이터가 포함된 XML 부분을 구성하여 문서의 CustomXmlPart 컬렉션에 추가해야 합니다. 이 사용자 지정 XML 부분은 구조화된 문서 태그의 데이터 소스 역할을 합니다.

XML 파트 생성

먼저, XML 부분에 대한 고유 ID를 생성하고 해당 내용을 정의합니다.

// 데이터가 포함된 XML 부분을 구성하여 문서의 CustomXmlPart 컬렉션에 추가합니다.
string xmlPartId = Guid.NewGuid().ToString("B");
string xmlPartContent = "<root><text>Text element #1</text><text>Text element #2</text></root>";
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(xmlPartId, xmlPartContent);

XML 부분 내용 확인

XML 부분이 올바르게 추가되었는지 확인하기 위해 해당 내용을 인쇄합니다.

Console.WriteLine(Encoding.UTF8.GetString(xmlPart.Data));

4단계: 구조화된 문서 태그 만들기

구조화된 문서 태그(SDT)는 XML 파트에 바인딩할 수 있는 콘텐츠 컨트롤입니다. 여기서 사용자 지정 XML 파트의 콘텐츠를 표시하는 SDT를 만듭니다.

먼저, 문서에서 SDT 범위 시작을 찾습니다.

StructuredDocumentTagRangeStart sdtRangeStart = (StructuredDocumentTagRangeStart)doc.GetChild(NodeType.StructuredDocumentTagRangeStart, 0, true);

5단계: SDT에 대한 XML 매핑 설정

이제 XML 부분을 SDT에 바인딩할 시간입니다. XML 매핑을 설정하여 XML 데이터의 어느 부분을 SDT에 표시할지 지정합니다.

XPath는 우리가 표시하고자 하는 XML 부분의 특정 요소를 가리킵니다. 여기서 우리는 두 번째를 가리킵니다.<text> 내부의 요소<root> 요소.

// StructuredDocumentTag에 대한 매핑을 설정합니다.
sdtRangeStart.XmlMapping.SetMapping(xmlPart, "/root[1]/text[2]", null);

6단계: 문서 저장

마지막으로 문서를 저장하여 변경 사항을 실제로 확인해 보세요. 이제 Word 문서의 SDT가 지정된 XML 콘텐츠를 표시합니다.

doc.Save(dataDir + "WorkingWithSdt.StructuredDocumentTagRangeStartXmlMapping.docx");

결론

이제 아시겠죠! Aspose.Words for .NET을 사용하여 XML 부분을 Word 문서의 구조화된 문서 태그에 성공적으로 매핑했습니다. 이 강력한 기능을 사용하면 동적이고 데이터 중심의 문서를 손쉽게 만들 수 있습니다. 보고서, 송장 또는 기타 문서 유형을 생성하든 XML 매핑은 워크플로를 크게 간소화할 수 있습니다.

자주 묻는 질문

Word에서 구조화된 문서 태그란 무엇입니까?

구조화된 문서 태그는 콘텐츠 컨트롤이라고도 하며, Word 문서의 특정 유형의 콘텐츠를 담는 컨테이너입니다. 데이터를 바인딩하고, 편집을 제한하거나, 사용자가 문서를 만들도록 안내하는 데 사용할 수 있습니다.

XML 부분의 내용을 동적으로 업데이트하려면 어떻게 해야 하나요?

XML 부분 콘텐츠를 수정하여 업데이트할 수 있습니다.xmlPartContent 문서에 추가하기 전에 문자열을 업데이트하십시오. 새 데이터로 문자열을 업데이트하고 문서에 추가하기만 하면 됩니다.CustomXmlParts 수집.

동일한 문서에서 여러 XML 부분을 서로 다른 SDT에 바인딩할 수 있나요?

네, 여러 XML 부분을 동일한 문서의 다른 SDT에 바인딩할 수 있습니다. 각 SDT는 고유한 XML 부분과 XPath 매핑을 가질 수 있습니다.

복잡한 XML 구조를 SDT에 매핑하는 것이 가능할까?

물론입니다! XML 부분 내의 원하는 요소를 정확하게 가리키는 자세한 XPath 표현식을 사용하여 복잡한 XML 구조를 SDT에 매핑할 수 있습니다.

문서에서 XML 부분을 제거하려면 어떻게 해야 하나요?

XML 부분을 제거하려면 다음을 호출하면 됩니다.Remove 방법에 대한CustomXmlParts 수집, 전달xmlPartId 제거하려는 XML 부분입니다.