Cum să lucrați cu markup-ul XML personalizat în .NET

Pasul 1: Citiți datele XML personalizate dintr-un document

Document.CustomXmlParts returnează un CustomXmlPartCollection — același mecanism pe care Word îl folosește pentru a susține controalele de conținut mapate la XML. Iterați colecția sau apelați GetById(id) când știți deja ce parte aveți nevoie, pentru a obține un CustomXmlPart. Fiecare parte expune Id, un Data tablou de octeți care conține XML brut, un DataChecksum pentru detectarea modificărilor datelor fără o comparație completă a octeților și Schemas — un CustomXmlSchemaCollection care listează schemele XML asociate cu aceasta.

Pasul 2: Adăugați sau actualizați o parte XML personalizată

Apelați CustomXmlPartCollection.Add(id, xml) cu un șir de identificare și conținutul XML pentru a crea direct o parte, sau construiți un CustomXmlPart separat și îl transmiteți la Add(part). Pentru a elimina datele, utilizați RemoveAt(index) pe o poziție specifică sau Clear() pentru a șterge fiecare parte. Când copiați datele XML personalizate între documente, folosiți CustomXmlPart.Clone() (sau Clone() din colecție) pe partea sursă în loc să re-citiți și să adăugați din nou XML brut, apoi adăugați clonul la Document.CustomXmlParts din documentul țintă.

Pasul 3: Gestionați schemele asociate cu o parte

CustomXmlPart.Schemas ajunge la un CustomXmlSchemaCollection, care urmărește URI-urile de schemă asociate cu partea ca șiruri simple în loc de obiecte de schemă analizate. Utilizați Add(value) pentru a înregistra un URI de schemă, Remove(name) sau RemoveAt(index) pentru a elimina unul, IndexOf(value) pentru a localiza unul și Clear() pentru a le elimina pe toate. Count raportează câte URI-uri de schemă sunt în prezent asociate cu partea.

Pasul 4: Lucrați cu părți personalizate la nivel de pachet

Nu fiecare parte nevizibilă dintr-un pachet OOXML este XML personalizat. Document.PackageCustomParts returnează un CustomPartCollection de obiecte CustomPart — părți arbitrare stocate în pachet, cum ar fi părți adăugate de o altă aplicație care a modificat fișierul. Fiecare CustomPart are un Name, ContentType, RelationshipType, un tablou de octeți Data și un semnal IsExternal care indică dacă este o referință externă în loc de conținut încorporat. Add(part), RemoveAt(index) și Clear() gestionează colecția în același mod ca CustomXmlPartCollection. Verificați PackageCustomParts — nu CustomXmlParts — atunci când o parte pe care documentul dvs. ar trebui să o conțină nu apare în colecția XML personalizată.

Pasul 5: Inspectați etichetele inteligente vechi și proprietățile lor

SmartTag este un tip de nod (NodeType.SmartTag, construit cu SmartTag(doc)) care reprezintă o etichetă inteligentă legacy Word înfășurată în jurul textului recunoscut. Verificați Element și Uri împreună pentru a identifica care recunoaștor a creat eticheta, apoi citiți Properties — un CustomXmlPropertyCollection — pentru datele structurate pe care recunoaștorul le-a atașat. Într-un CustomXmlPropertyCollection, indexatorul (de ex. properties["MyProp"]) sau Contains(name) caută o proprietate specifică, IndexOfKey(name) returnează poziția acesteia, iar Remove(name)/RemoveAt(index)/Clear() elimină intrările; fiecare CustomXmlProperty este construit cu CustomXmlProperty(name, uri, value) și expune Name, Uri și Value. Deoarece SmartTag derivă din CompositeNode, participă și el la arborele documentului ca alte noduri, susținând Accept(visitor), AcceptStart(visitor) și AcceptEnd(visitor) pentru traversare bazată pe DocumentVisitor.