Εύρος ετικετών δομημένου εγγράφου Έναρξη αντιστοίχισης Xml

Εισαγωγή

Θέλατε ποτέ να εισαγάγετε δυναμικά δεδομένα XML σε ένα έγγραφο του Word; Λοιπόν, είσαι τυχερός! Το Aspose.Words for .NET κάνει αυτήν την εργασία παιχνιδάκι. Σε αυτό το σεμινάριο, βουτάμε βαθιά στη χαρτογράφηση XML έναρξης εύρους ετικετών δομημένου εγγράφου. Αυτή η δυνατότητα σάς επιτρέπει να συνδέετε προσαρμοσμένα μέρη XML σε στοιχεία ελέγχου περιεχομένου, διασφαλίζοντας ότι το περιεχόμενο του εγγράφου σας ενημερώνεται απρόσκοπτα με τα δεδομένα XML σας. Έτοιμοι να μετατρέψετε τα έγγραφά σας σε δυναμικά αριστουργήματα.

Προαπαιτούμενα

Πριν προχωρήσουμε στο κομμάτι της κωδικοποίησης, ας βεβαιωθούμε ότι έχετε όλα όσα χρειάζεστε:

Aspose.Words for .NET Library: Βεβαιωθείτε ότι διαθέτετε την πιο πρόσφατη έκδοση. Μπορείτε να το κατεβάσετεεδώ.
Περιβάλλον ανάπτυξης: Visual Studio ή οποιοδήποτε άλλο IDE που υποστηρίζει C#.
Βασικές γνώσεις C#: Η εξοικείωση με τον προγραμματισμό C# είναι απαραίτητη.
Έγγραφο Word: Ένα δείγμα εγγράφου του Word για εργασία.

Εισαγωγή χώρων ονομάτων

Πρώτα πράγματα πρώτα, ας εισάγουμε τους απαραίτητους χώρους ονομάτων. Αυτό θα διασφαλίσει ότι έχουμε πρόσβαση σε όλες τις απαιτούμενες κλάσεις και μεθόδους στο Aspose.Words για .NET.

using System;
using Aspose.Words;
using Aspose.Words.Markup;
using System.Text;

Βήμα 1: Ρυθμίστε τον Κατάλογο Εγγράφων σας

Κάθε έργο χρειάζεται μια βάση, σωστά; Εδώ, ορίζουμε τη διαδρομή προς τον κατάλογο εγγράφων σας.

// Διαδρομή στον κατάλογο εγγράφων σας
string dataDir = "YOUR DOCUMENT DIRECTORY";

Βήμα 2: Φορτώστε το έγγραφο του Word

Στη συνέχεια, φορτώνουμε το έγγραφο του Word. Αυτό είναι το έγγραφο όπου θα εισάγουμε τα δεδομένα XML μας.

Document doc = new Document(dataDir + "Multi-section structured document tags.docx");

Βήμα 3: Προσθέστε προσαρμοσμένο τμήμα XML

Πρέπει να κατασκευάσουμε ένα τμήμα XML που να περιέχει τα δεδομένα που θέλουμε να εισαγάγουμε και να το προσθέσουμε στη συλλογή CustomXmlPart του εγγράφου. Αυτό το προσαρμοσμένο τμήμα XML θα χρησιμεύσει ως η πηγή δεδομένων για τις ετικέτες δομημένων εγγράφων μας.

Δημιουργία τμήματος XML

Αρχικά, δημιουργήστε ένα μοναδικό αναγνωριστικό για το τμήμα XML και ορίστε το περιεχόμενό του.

// Κατασκευάστε ένα τμήμα XML που περιέχει δεδομένα και προσθέστε το στη συλλογή CustomXmlPart του εγγράφου.
string xmlPartId = Guid.NewGuid().ToString("B");
string xmlPartContent = "<root><text>Text element #1</text><text>Text element #2</text></root>";
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(xmlPartId, xmlPartContent);

Επαληθεύστε το περιεχόμενο του τμήματος XML

Για να διασφαλίσουμε ότι το τμήμα XML έχει προστεθεί σωστά, εκτυπώνουμε το περιεχόμενό του.

Console.WriteLine(Encoding.UTF8.GetString(xmlPart.Data));

Βήμα 4: Δημιουργήστε μια ετικέτα δομημένου εγγράφου

Το Structured Document Tag (SDT) είναι ένα στοιχείο ελέγχου περιεχομένου που μπορεί να συνδεθεί σε ένα τμήμα XML. Εδώ, δημιουργούμε ένα SDT που θα εμφανίζει τα περιεχόμενα του προσαρμοσμένου τμήματος XML.

Αρχικά, εντοπίστε την αρχή του εύρους SDT στο έγγραφο.

StructuredDocumentTagRangeStart sdtRangeStart = (StructuredDocumentTagRangeStart)doc.GetChild(NodeType.StructuredDocumentTagRangeStart, 0, true);

Βήμα 5: Ορίστε τη χαρτογράφηση XML για το SDT

Τώρα, ήρθε η ώρα να συνδέσουμε το τμήμα XML στο SDT. Ορίζοντας μια αντιστοίχιση XML, καθορίζουμε ποιο μέρος των δεδομένων XML πρέπει να εμφανίζεται στο SDT.

Το XPath δείχνει το συγκεκριμένο στοιχείο στο τμήμα XML που θέλουμε να εμφανίσουμε. Εδώ, επισημαίνουμε το δεύτερο<text> στοιχείο εντός του<root> στοιχείο.

// Ορίστε μια αντιστοίχιση για το StructuredDocumentTag
sdtRangeStart.XmlMapping.SetMapping(xmlPart, "/root[1]/text[2]", null);

Βήμα 6: Αποθηκεύστε το έγγραφο

Τέλος, αποθηκεύστε το έγγραφο για να δείτε τις αλλαγές σε δράση. Το SDT στο έγγραφο του Word θα εμφανίσει τώρα το καθορισμένο περιεχόμενο XML.

doc.Save(dataDir + "WorkingWithSdt.StructuredDocumentTagRangeStartXmlMapping.docx");

Σύναψη

Και ορίστε το! Αντιστοιχίσατε με επιτυχία ένα τμήμα XML σε μια ετικέτα δομημένου εγγράφου σε ένα έγγραφο του Word χρησιμοποιώντας το Aspose.Words για .NET. Αυτή η ισχυρή δυνατότητα σάς δίνει τη δυνατότητα να δημιουργείτε δυναμικά και βασισμένα σε δεδομένα έγγραφα χωρίς κόπο. Είτε δημιουργείτε αναφορές, τιμολόγια ή οποιονδήποτε άλλο τύπο εγγράφου, η αντιστοίχιση XML μπορεί να βελτιώσει σημαντικά τη ροή εργασίας σας.

Συχνές ερωτήσεις

Τι είναι μια ετικέτα δομημένου εγγράφου στο Word;

Οι ετικέτες δομημένων εγγράφων, γνωστές και ως στοιχεία ελέγχου περιεχομένου, είναι κοντέινερ για συγκεκριμένους τύπους περιεχομένου σε έγγραφα του Word. Μπορούν να χρησιμοποιηθούν για τη σύνδεση δεδομένων, τον περιορισμό της επεξεργασίας ή την καθοδήγηση των χρηστών στη δημιουργία εγγράφων.

Πώς μπορώ να ενημερώσω δυναμικά το περιεχόμενο του τμήματος XML;

Μπορείτε να ενημερώσετε το περιεχόμενο του τμήματος XML τροποποιώντας τοxmlPartContent συμβολοσειρά πριν την προσθέσετε στο έγγραφο. Απλώς ενημερώστε τη συμβολοσειρά με τα νέα δεδομένα και προσθέστε τη στοCustomXmlParts συλλογή.

Μπορώ να συνδέσω πολλά μέρη XML σε διαφορετικά SDT στο ίδιο έγγραφο;

Ναι, μπορείτε να συνδέσετε πολλά μέρη XML σε διαφορετικά SDT στο ίδιο έγγραφο. Κάθε SDT μπορεί να έχει το δικό του μοναδικό τμήμα XML και αντιστοίχιση XPath.

Είναι δυνατή η αντιστοίχιση σύνθετων δομών XML σε SDT;

Απολύτως! Μπορείτε να αντιστοιχίσετε σύνθετες δομές XML σε SDT χρησιμοποιώντας λεπτομερείς εκφράσεις XPath που δείχνουν με ακρίβεια τα επιθυμητά στοιχεία μέσα στο τμήμα XML.

Πώς μπορώ να αφαιρέσω ένα τμήμα XML από ένα έγγραφο;

Μπορείτε να αφαιρέσετε ένα τμήμα XML καλώντας τοRemove μέθοδος στοCustomXmlParts συλλογή, περνώντας τοxmlPartId του τμήματος XML που θέλετε να καταργήσετε.