Πώς να εργαστείτε με πεδία μετάβασης στο .NET

Βήμα 1: Εντοπίστε τα μεταβατικά πεδία σε ένα έγγραφο

Απαριθμήστε το Document.Range.Fields και συγκρίνετε το Type κάθε πεδίου (μια τιμή FieldType) με τις σχετικές σταθερές — FieldBarcode, FieldDisplayBarcode, FieldMergeBarcode, FieldBidiOutline, FieldEQ, FieldFootnoteRef ή FieldInfo — μετά μετατρέψτε το γενικό Field στην αντίστοιχη κλάση για πρόσβαση στις συγκεκριμένες ιδιότητές του. Πάντα ελέγξτε το Type πριν τη μετατροπή: η μετατροπή σε λανθασμένη κλάση πεδίου προκαλεί ένα InvalidCastException.

Βήμα 2: Διαμορφώστε ένα πεδίο DISPLAYBARCODE ή MERGEBARCODE

FieldDisplayBarcode (το πεδίο DISPLAYBARCODE) και FieldMergeBarcode (το πεδίο MERGEBARCODE, το οποίο επίσης υλοποιεί το IMergeFieldSurrogate για συγχώνευση αλληλογραφίας) μοιράζονται το ίδιο σύνολο ιδιοτήτων ρύθμισης barcode: BarcodeType, BarcodeValue, SymbolHeight, SymbolRotation, ScalingFactor, ForegroundColor, BackgroundColor, PosCodeStyle, CaseCodeStyle, ErrorCorrectionLevel, DisplayText, AddStartStopChar και FixCheckDigit. Ορίστε αυτές στην παρουσία του πεδίου, μετά καλέστε το Update() ώστε το Result να αντικατοπτρίζει τη νέα ρύθμιση πριν αποθηκευτεί το έγγραφο.

Βήμα 3: Διαβάστε τα δεδομένα του παλαιού πεδίου BARCODE (Ταχυδρομικό)

FieldBarcode υλοποιεί το παλαιότερο πεδίο BARCODE, το οποίο είναι συγκεκριμένα ένα πεδίο αμερικανικού ταχυδρομικού barcode (POSTNET) αντί για ένα γενικού σκοπού barcode — δεν μοιράζεται τις ιδιότητες BarcodeType/BarcodeValue από το Βήμα 2. Αντίθετα, εκθέτει το PostalAddress (τη διεύθυνση που κωδικοποιεί το barcode), FacingIdentificationMark, IsUSPostalAddress και IsBookmark. Ελέγξτε το Field.Type έναντι του FieldType.FieldBarcode ειδικά πριν διαβάσετε αυτές τις ιδιότητες, καθώς η μετατροπή ενός πεδίου DISPLAYBARCODE ή MERGEBARCODE σε FieldBarcode δεν θα εκθέσει τις ιδιότητες που αναμένετε.

Βήμα 4: Απόδοση εικόνων Barcode με προσαρμοσμένο γεννήτορα

Αυτή η έκδοση FOSS μεταφέρει δεδομένα πεδίου barcode αλλά δεν περιλαμβάνει μηχανή απόδοσης barcode. Το BarcodeParameters είναι το κοντέινερ διέλευσης που ενοποιεί ρυθμίσεις από οποιαδήποτε οικογένεια πεδίων barcode — τις ιδιότητες DISPLAYBARCODE/MERGEBARCODE από το Βήμα 2 και τις ταχυδρομικές ιδιότητες από το Βήμα 3 — σε ένα ενιαίο αντικείμενο που παραδίδεται σε έναν renderer. Υλοποιήστε το IBarcodeGenerator, εκθέτοντας το GetBarcodeImage(parameters) και το κληρονομημένο GetOldBarcodeImage(parameters), για να παρέχετε την πραγματική απόδοση εικόνας· χωρίς παρεχόμενη υλοποίηση, τα πεδία barcode μεταφέρουν μόνο δεδομένα ρύθμισης.

Βήμα 5: Εργασία με πεδία συμβατότητας παλαιού τύπου

Τέσσερις άλλες κλάσεις καλύπτουν παλαιότερους κωδικούς πεδίων που εξακολουθούν να εμφανίζονται σε αρχεία .docx παλαιού τύπου. Το FieldBidiOutline υλοποιεί το πεδίο BIDIOUTLINE για αρίθμηση περιγράμματος από δεξιά προς αριστερά και δεν εκθέτει ιδιότητες πέρα από την κοινή επιφάνεια Field. Το FieldEQ υλοποιεί το πεδίο εξίσωσης EQ και επιπλέον εκθέτει το AsOfficeMath() για μετατροπή του περιεχομένου του σε αντικείμενο OfficeMath — αυτό επιτυγχάνει μόνο όταν το πεδίο κωδικοποιεί πράγματι μια εξίσωση. Το FieldFootnoteRef υλοποιεί το πεδίο FOOTNOTEREF, το οποίο διασυνδέει μια σημείωση υποσημειώματος ή τέλους σημειώματος, και επίσης δεν εκθέτει ιδιότητες πέρα από την κοινή επιφάνεια Field. Το FieldInfo υλοποιεί το πεδίο INFO, διαβάζοντας ή γράφοντας μια ιδιότητα σύνοψης-πληροφορίας εγγράφου μέσω των ιδιοτήτων του InfoType και NewValue.

Βήμα 6: Ενημέρωση ή παγώστε την τιμή ενός μεταβατικού πεδίου

Κάθε κλάση μεταβατικού πεδίου κληρονομεί το GetFieldCode() (το υποκείμενο κείμενο κώδικα του πεδίου), το Update() (επανυπολογίζει το αποτέλεσμα), το Unlink() (αντικαθιστά το πεδίο με το τελευταίο υπολογισμένο αποτέλεσμα ως στατικό κείμενο) και το Remove() (διαγράφει το πεδίο). Καλείστε το Update() μετά την αλλαγή της διαμόρφωσης οποιουδήποτε πεδίου ώστε το Result να αντανακλά την αλλαγή, και χρησιμοποιήστε το Unlink() όταν η τρέχουσα τιμή ενός πεδίου πρέπει να παγώσει αντί να παραμένει επαναϋπολογίσιμη.