Πώς να εργαστείτε με προσαρμοσμένη XML σήμανση στο .NET

Βήμα 1: Ανάγνωση προσαρμοσμένων δεδομένων XML από ένα έγγραφο

Document.CustomXmlParts επιστρέφει ένα CustomXmlPartCollection — ο ίδιος μηχανισμός που χρησιμοποιεί το Word για την υποστήριξη ελέγχων περιεχομένου που αντιστοιχούν σε XML. Επαναλάβετε τη συλλογή ή καλέστε το GetById(id) όταν ήδη γνωρίζετε ποιο τμήμα χρειάζεστε, για να λάβετε ένα CustomXmlPart. Κάθε τμήμα αποκαλύπτει το Id, έναν Data πίνακα byte που περιέχει το ακατέργαστο XML, ένα DataChecksum για τον εντοπισμό εάν τα δεδομένα έχουν αλλάξει χωρίς πλήρη σύγκριση byte, και το Schemas — ένα CustomXmlSchemaCollection που απαριθμεί τα σχήματα XML που σχετίζονται με αυτό.

Βήμα 2: Προσθήκη ή ενημέρωση προσαρμοσμένου τμήματος XML

Καλέστε CustomXmlPartCollection.Add(id, xml) με μια συμβολοσειρά id και το περιεχόμενο XML για να δημιουργήσετε ένα μέρος άμεσα, ή δημιουργήστε ένα CustomXmlPart ξεχωριστά και περάστε το στο Add(part). Για να αφαιρέσετε δεδομένα, χρησιμοποιήστε RemoveAt(index) σε συγκεκριμένη θέση ή Clear() για να αφαιρέσετε κάθε μέρος. Όταν αντιγράφετε προσαρμοσμένα δεδομένα XML μεταξύ εγγράφων, χρησιμοποιήστε CustomXmlPart.Clone() (ή το Clone() της συλλογής) στο πηγαίο μέρος αντί να ξαναδιαβάσετε και να προσθέσετε ξανά το ακατέργαστο XML, μετά προσθέστε το κλώνο στο Document.CustomXmlParts του στοχευμένου εγγράφου.

Βήμα 3: Διαχειριστείτε τα Σχήματα που Σχετίζονται με ένα Μέρος

CustomXmlPart.Schemas φθάνει σε ένα CustomXmlSchemaCollection, το οποίο παρακολουθεί τις URI σχήματος που σχετίζονται με το μέρος ως απλές συμβολοσειρές αντί για αναλυτικά αντικείμενα σχήματος. Χρησιμοποιήστε Add(value) για να καταχωρήσετε μια URI σχήματος, Remove(name) ή RemoveAt(index) για να αφαιρέσετε μία, IndexOf(value) για να εντοπίσετε μία, και Clear() για να τις αφαιρέσετε όλες. Count αναφέρει πόσες URI σχήματος είναι αυτή τη στιγμή συνδεδεμένες με το μέρος.

Βήμα 4: Εργαστείτε με Προσαρμοσμένα Μέρη Επιπέδου Πακέτου

Δεν κάθε μη ορατό μέρος σε ένα πακέτο OOXML είναι προσαρμοσμένο XML. Το Document.PackageCustomParts επιστρέφει ένα CustomPartCollection από αντικείμενα CustomPart — αυθαίρετα μέρη που αποθηκεύονται στο πακέτο, όπως μέρη που προστέθηκαν από άλλη εφαρμογή που επηρέασε το αρχείο. Κάθε CustomPart έχει ένα Name, ContentType, RelationshipType, έναν πίνακα byte Data και μια σημαία IsExternal που υποδεικνύει αν είναι εξωτερική αναφορά αντί για ενσωματωμένο περιεχόμενο. Τα Add(part), RemoveAt(index) και Clear() διαχειρίζονται τη συλλογή με τον ίδιο τρόπο όπως το CustomXmlPartCollection. Ελέγξτε το PackageCustomParts — όχι το CustomXmlParts — όταν ένα μέρος που το έγγραφό σας πρέπει να περιλαμβάνει δεν εμφανίζεται στη συλλογή προσαρμοσμένων XML.

Βήμα 5: Επιθεωρήστε τις Παλαιότερες Έξυπνες Ετικέτες και τις Ιδιότητές τους

SmartTag είναι ένας τύπος κόμβου (NodeType.SmartTag, κατασκευασμένος με SmartTag(doc)) που αντιπροσωπεύει μια παλαιότερη έξυπνη ετικέτα Word τυλιγμένη γύρω από αναγνωρισμένο κείμενο. Ελέγξτε τα 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, συμμετέχει επίσης στο δέντρο του εγγράφου όπως άλλοι κόμβοι, υποστηρίζοντας τα Accept(visitor), AcceptStart(visitor) και AcceptEnd(visitor) για περιήγηση βασισμένη σε DocumentVisitor.