맞춤 XML 마크업을 .NET에서 작업하는 방법

1단계: 문서에서 사용자 정의 XML 데이터 읽기

Document.CustomXmlParts은 CustomXmlPartCollection을 반환합니다 — 이는 Word가 XML 매핑된 콘텐츠 컨트롤을 지원하는 데 사용하는 동일한 메커니즘입니다. 컬렉션을 반복하거나 필요한 파트를 이미 알고 있을 경우 GetById(id)를 호출하여 CustomXmlPart을 얻습니다. 각 파트는 Id를 노출하는데, 이는 원시 XML을 보유한 Data 바이트 배열이며, 전체 바이트 비교 없이 데이터 변경 여부를 감지하는 DataChecksum와, 해당 파트와 연관된 XML 스키마를 나열하는 CustomXmlSchemaCollection인 Schemas을 포함합니다.

2단계: 사용자 정의 XML 파트 추가 또는 업데이트

ID 문자열과 XML 내용을 사용하여 CustomXmlPartCollection.Add(id, xml)을(를) 호출하면 파트를 직접 생성할 수 있으며, 별도로 CustomXmlPart을(를) 구성한 뒤 Add(part)에 전달할 수도 있습니다. 데이터를 제거하려면 특정 위치에서 RemoveAt(index)을(를) 사용하거나 모든 파트를 삭제하려면 Clear()을(를) 사용합니다. 문서 간에 사용자 정의 XML 데이터를 복사할 때는 원본 파트에서 원시 XML를 다시 읽고 다시 추가하는 대신 CustomXmlPart.Clone()(또는 컬렉션의 Clone())를 사용하고, 복제본을 대상 문서의 Document.CustomXmlParts에 추가합니다.

3단계: 파트와 연결된 스키마 관리

CustomXmlPart.Schemas은(는) CustomXmlSchemaCollection에 도달하며, 여기서는 파트와 연결된 스키마 URI를 구문 분석된 스키마 객체가 아니라 일반 문자열로 추적합니다. 스키마 URI를 등록하려면 Add(value)을(를) 사용하고, 하나를 삭제하려면 Remove(name) 또는 RemoveAt(index)을(를) 사용하며, 하나를 찾으려면 IndexOf(value)을(를) 사용하고, 모두 제거하려면 Clear()을(를) 사용합니다. Count은(는) 현재 파트와 연결된 스키마 URI 개수를 보고합니다.

4단계: 패키지 수준 사용자 정의 파트 작업

OOXML 패키지의 모든 비가시 파트가 사용자 정의 XML는 아닙니다. Document.PackageCustomParts은(는) CustomPart 객체들의 CustomPartCollection을(를) 반환합니다 — 파일을 수정한 다른 애플리케이션이 추가한 파트와 같이 패키지에 저장된 임의의 파트입니다. 각 CustomPart은 Name, ContentType, RelationshipType 및 Data 바이트 배열과, 내장 콘텐츠가 아니라 외부 참조인지 여부를 나타내는 IsExternal 플래그를 가지고 있습니다. Add(part), RemoveAt(index), Clear()은(는) CustomXmlPartCollection와 동일한 방식으로 컬렉션을 관리합니다. 문서가 가져야 할 파트가 사용자 정의 XML 컬렉션에 나타나지 않을 때는 PackageCustomParts을(를) 확인하십시오 — CustomXmlParts이(가) 아니라.

5단계: 레거시 스마트 태그 및 해당 속성 검사

SmartTag은(는) 인식된 텍스트 주위에 둘러싸인 레거시 Word 스마트 태그를 나타내는 노드 유형(NodeType.SmartTag, SmartTag(doc)로 구성)입니다. 어떤 인식기가 태그를 생성했는지 확인하려면 Element과 Uri를 함께 확인하고, 인식기가 첨부한 구조화된 데이터를 얻기 위해 Properties—CustomXmlPropertyCollection—을 읽습니다. CustomXmlPropertyCollection 내부에서 인덱서(예: properties["MyProp"]) 또는 Contains(name)는 특정 속성을 조회하고, IndexOfKey(name)은 그 위치를 반환하며, Remove(name)/RemoveAt(index)/Clear()은 항목을 제거합니다; 각 CustomXmlProperty는 CustomXmlProperty(name, uri, value)로 구성되고 Name, Uri, Value을(를) 노출합니다. SmartTag가 CompositeNode에서 파생되었기 때문에 다른 노드와 마찬가지로 문서 트리에 참여하며, DocumentVisitor 기반 순회를 위해 Accept(visitor), AcceptStart(visitor), AcceptEnd(visitor)을(를) 지원합니다.