Hur man arbetar med anpassad XML markup i .NET

Steg 1: Läs anpassad XML-data från ett dokument

Document.CustomXmlParts returnerar en CustomXmlPartCollection — samma mekanism som Word använder för att stödja XML-mappade innehållskontroller. Iterera samlingen, eller anropa GetById(id) när du redan vet vilken del du behöver, för att få en CustomXmlPart. Varje del exponerar Id, en Data byte-array som innehåller den råa XML, en DataChecksum för att upptäcka om datan har förändrats utan en full byte-jämförelse, och Schemas — en CustomXmlSchemaCollection som listar de XML-scheman som är associerade med den.

Steg 2: Lägg till eller uppdatera en anpassad XML-del

Anropa CustomXmlPartCollection.Add(id, xml) med en id-sträng och XML-innehållet för att skapa en del direkt, eller konstruera en CustomXmlPart separat och skicka den till Add(part). För att ta bort data, använd RemoveAt(index) på en specifik position eller Clear() för att ta bort varje del. När du kopierar anpassad XML-data mellan dokument, använd CustomXmlPart.Clone() (eller samlingens Clone()) på källdelen istället för att läsa om och lägga till den råa XML, lägg sedan till klonen i mål dokumentets Document.CustomXmlParts.

Steg 3: Hantera scheman som är associerade med en del

CustomXmlPart.Schemas når en CustomXmlSchemaCollection, som spårar schema-URI:er som är associerade med delen som enkla strängar snarare än analyserade schemaobjekt. Använd Add(value) för att registrera en schema-URI, Remove(name) eller RemoveAt(index) för att ta bort en, IndexOf(value) för att hitta en, och Clear() för att ta bort dem alla. Count rapporterar hur många schema-URI:er som för närvarande är associerade med delen.

Steg 4: Arbeta med paketnivåanpassade delar

Inte varje icke-synlig del i ett OOXML-paket är en anpassad XML. Document.PackageCustomParts returnerar en CustomPartCollection av CustomPart-objekt — godtyckliga delar som lagras i paketet, såsom delar som lagts till av ett annat program som har rört filen. Varje CustomPart har en Name, ContentType, RelationshipType, en Data byte-array och en IsExternal flagga som indikerar om det är en extern referens snarare än inbäddat innehåll. Add(part), RemoveAt(index) och Clear() hanterar samlingen på samma sätt som CustomXmlPartCollection. Kontrollera PackageCustomParts — inte CustomXmlParts — när en del som ditt dokument bör innehålla inte visas i den anpassade XML-samlingen.

Steg 5: Inspektera äldre smarta taggar och deras egenskaper

SmartTag är en nodtyp (NodeType.SmartTag, konstruerad med SmartTag(doc)) som representerar en äldre Word smart tag omsluten runt igenkänd text. Kontrollera Element och Uri tillsammans för att identifiera vilken igenkännare som skapade taggen, läs sedan Properties — en CustomXmlPropertyCollection — för den strukturerade data som igenkännaren bifogade. Inom en CustomXmlPropertyCollection letar indexeraren (t.ex. properties["MyProp"]) eller Contains(name) upp en specifik egenskap, IndexOfKey(name) returnerar dess position, och Remove(name)/RemoveAt(index)/Clear() tar bort poster; varje CustomXmlProperty konstrueras med CustomXmlProperty(name, uri, value) och exponerar Name, Uri och Value. Eftersom SmartTag ärver från CompositeNode deltar den också i dokumentträdet som andra noder, och stödjer Accept(visitor), AcceptStart(visitor) och AcceptEnd(visitor) för DocumentVisitor-baserad traversal.