Hogyan dolgozzunk egyedi XML jelölőnyelvvel a .NET-ban

1. lépés: Egyéni XML adatok olvasása egy dokumentumból

Document.CustomXmlParts egy CustomXmlPartCollection-t ad vissza — ugyanazt a mechanizmust, amelyet a Word a XML-leképezett tartalomvezérlők támogatására használ. Iterálja a gyűjteményt, vagy hívja meg a GetById(id)-t, ha már tudja, melyik részre van szüksége, hogy egy CustomXmlPart-t kapjon. Minden rész tartalmazza a Id-t, egy Data bájt tömböt, amely a nyers XML-t tartalmazza, egy DataChecksum-t az adatváltozás felismerésére teljes bájt összehasonlítás nélkül, és Schemas — egy CustomXmlSchemaCollection, amely felsorolja a hozzá kapcsolódó XML sémákat.

2. lépés: Egyéni XML rész hozzáadása vagy frissítése

Hívja meg a CustomXmlPartCollection.Add(id, xml) egy azonosító karakterlánccal és a XML tartalommal, hogy közvetlenül létrehozzon egy részt, vagy különállóan építsen fel egy CustomXmlPart és adja át a Add(part). Adatok eltávolításához használja a RemoveAt(index) egy adott pozíción, vagy a Clear() minden rész eldobásához. Egyedi XML adatok másolásakor dokumentumok között, használja a CustomXmlPart.Clone() (vagy a gyűjtemény Clone()) a forrásrészen a nyers XML újraolvasása és újra hozzáadása helyett, majd adja hozzá a klónt a céldokumentum Document.CustomXmlParts-éhez.

3. lépés: Kezelje a részhez kapcsolódó sémákat

CustomXmlPart.Schemas elér egy CustomXmlSchemaCollection-t, amely a részhez kapcsolódó sémák URI-it egyszerű karakterláncként, nem pedig elemzett sémaobjektumként követi. Használja a Add(value)-t egy séma URI regisztrálásához, a Remove(name) vagy a RemoveAt(index)-t egy eltávolításához, a IndexOf(value)-t egy megtaláláshoz, és a Clear()-t mindegyik eltávolításához. A Count jelzi, hogy hány séma URI van jelenleg a részhez kapcsolódva.

4. lépés: Dolgozzon a csomagszintű egyedi részekkel

Nem minden láthatatlan rész egy OOXML csomagban egyedi XML. A Document.PackageCustomParts egy CustomPartCollection típusú CustomPart objektumot ad vissza – tetszőleges részeket, amelyeket a csomag tárol, például olyan részeket, amelyeket egy másik alkalmazás adott hozzá a fájlhoz. Minden CustomPart rendelkezik egy Name, egy ContentType, egy RelationshipType, egy Data bájt tömbbel, és egy IsExternal jelzővel, amely azt mutatja, hogy külső hivatkozásról van-e szó a beágyazott tartalom helyett. A Add(part), RemoveAt(index) és Clear() ugyanúgy kezelik a gyűjteményt, mint a CustomXmlPartCollection. Ellenőrizze a PackageCustomParts-ot – ne a CustomXmlParts-ot – amikor egy olyan részt, amelynek a dokumentumnak tartalmaznia kellene, nem jelenik meg az egyedi XML gyűjteményben.

5. lépés: Vizsgálja meg a régi okos címkéket és azok tulajdonságait

SmartTag egy csomópont típus (NodeType.SmartTag, amelyet a SmartTag(doc) hoz létre), amely egy régi Word okos címkét képvisel, amely felismert szöveg köré van csomagolva. Ellenőrizze a Element és a Uri együtt, hogy meghatározza, melyik felismerő hozta létre a címkét, majd olvassa a Properties-t — egy CustomXmlPropertyCollection — a struktúrált adatokért, amelyet a felismerő csatolt. Egy CustomXmlPropertyCollection belsejében az indexelő (pl. properties["MyProp"]) vagy a Contains(name) keresi egy adott tulajdonságot, a IndexOfKey(name) visszaadja annak pozícióját, és a Remove(name)/RemoveAt(index)/Clear() eltávolítja a bejegyzéseket; minden CustomXmlProperty a CustomXmlProperty(name, uri, value)-kel van felépítve, és a Name, Uri és Value-et teszi elérhetővé. Mivel a SmartTag a CompositeNode-ból származik, ezért részt vesz a dokumentumfa struktúrájában is, mint a többi csomópont, támogatva a Accept(visitor), AcceptStart(visitor) és AcceptEnd(visitor)-t a DocumentVisitor alapú bejáráshoz.