Εργασία με Συνδέσμους και Αναφορές
Επισκόπηση
Κωδικοί πεδίων συνδέσμου και παραπομπής του Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, και άλλα – υλοποιούνται καθένα ως ένα αφιερωμένο Field υποκατηγορία σε Aspose.Words FOSS για .NET. Όλες αυτές οι κλάσεις ζουν στο Aspose.Words.Fields namespace μαζί με κάθε άλλο τύπο πεδίου· αυτή η σελίδα ομαδοποιεί εκείνες που αφορούν ειδικά συνδέσμους, παραπομπές, προτεινόμενες τιμές και αναφορές, και καλύπτει τι εκθέτει το καθένα.
Hyperlinks
FieldHyperlink αντιπροσωπεύει το πεδίο HYPERLINK: Address και SubAddress κρατούν τη διεύθυνση URL προορισμού ή τη θέση εντός του εγγράφου, ScreenTip ορίζει το tooltip κατά το πέρασμα του ποντικιού, OpenInNewWindow και IsImageMap είναι σημαίες εμφάνισης, και Target ονομάζει ένα πλαίσιο του προγράμματος περιήγησης. Για απλές περιπτώσεις, το DocumentBuilder.InsertHyperlink() εισάγει ένα πεδίο υπερσυνδέσμου απευθείας χωρίς να κατασκευάσει το αντικείμενο Field με το χέρι.
Διασταυρούμενες Αναφορές σε Σελιδοδείκτες
FieldRef (το πεδίο REF), FieldPageRef (PAGEREF), και FieldNoteRef (NOTEREF) καθένα αναλύει το περιεχόμενο σε έναν ονομασμένο σελιδοδείκτη μέσω της ιδιότητας BookmarkName, με τα InsertHyperlink και InsertRelativePosition να ελέγχουν αν η αναφορά είναι κλικ-δυνατή και αν αναφέρει σχετική θέση («πάνω» / «κάτω»). Το FieldRef προσθέτει επιλογές αρίθμησης παραγράφων (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) και IncludeNoteOrComment. Το FieldStyleRef (STYLEREF) αντί αυτού αναλύει την πλησιέστερη παράγραφο μορφοποιημένη με δεδομένο StyleName, με SearchFromBottom για αναζήτηση προς τα πίσω από τη θέση του πεδίου. Οι σελιδοδείκτες που στοχεύουν αυτά τα πεδία δημιουργούνται με DocumentBuilder.StartBookmark() και EndBookmark(), και μπορούν να πλοηγηθούν με MoveToBookmark(). Το FieldSet (SET) ορίζει μια τιμή κειμένου σελιδοδείκτη — BookmarkName και BookmarkText — που ένα πεδίο REF αλλού μπορεί να αναλύσει.
Πεδία Προτρεπόμενων Τιμών
FieldAsk (ASK) και FieldFillIn (FILLIN) ζητούν μια τιμή από όποιον ενημερώνει το πεδίο: PromptText εμφανίζεται στον χρήστη, DefaultResponse παρέχει εναλλακτική, και PromptOnceOnMailMerge περιορίζει την επαναλαμβανόμενη προτροπή κατά τη διάρκεια ενός mail merge. FieldAsk επιπλέον αποθηκεύει την απάντησή του στο BookmarkName για άλλα πεδία να το αναφέρουν. Δείτε το οδηγός πεδίων for IFieldUserPromptRespondent, η callback που παρέχει απαντήσεις σε αυτά τα πεδία προγραμματιστικά αντί για προτροπή διαδραστικά.
Εξωτερικό και Συνδεδεμένο Περιεχόμενο
FieldDde (DDE) και FieldDdeAuto (DDEAUTO) συνδέονται σε περιεχόμενο σε άλλη εφαρμογή μέσω ProgId, SourceFullName και SourceItem, με τα InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode και InsertAsBitmap να επιλέγουν την εισαχθείσα αναπαράσταση, και τα AutoUpdate / IsLinked να ελέγχουν τη συμπεριφορά ανανέωσης. Το FieldLink (LINK) είναι το ισοδύναμο OLE-link, προσθέτοντας το FormatUpdateType. Τα FieldImport (IMPORT) και FieldIncludePicture (INCLUDEPICTURE) φέρνουν ένα εξωτερικό γραφικό μέσω SourceFullName και GraphicFilter. Τα FieldInclude (INCLUDE) και FieldIncludeText (INCLUDETEXT) φέρνουν εξωτερικό περιεχόμενο εγγράφου, με το BookmarkName για να περιορίσει το περιεχόμενο που συμπεριλαμβάνεται και το LockFields για να αποτρέψει την ανανέωσή του· το FieldIncludeText υποστηρίζει επιπλέον πηγές XML μέσω Encoding, MimeType, NamespaceMappings, XPath και XslTransformation.
AutoText και Αναφορές Γλωσσαρίου
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) και FieldGlossary (GLOSSARY) αναφέρονται όλα σε μια ονομασμένη καταχώρηση δομικού μπλοκ μέσω EntryName; το FieldAutoTextList προσθέτει τα ListStyle και ScreenTip για την παρουσίαση του σε στυλ λίστας.
Πεδία Παραπομπής και Βιβλιογραφίας
FieldCitation (CITATION) και FieldBibliography (BIBLIOGRAPHY) αποδίδει περιεχόμενο που προέρχεται από τα δεδομένα βιβλιογραφίας του εγγράφου. FieldCitation.SourceTag (και το εναλλακτικό AnotherSourceTag) προσδιορίζει ποια πηγή παραθέτει, με Prefix, Suffix, PageNumber, VolumeNumber, και το Suppress* σημαίες (SuppressAuthor, SuppressTitle, SuppressYear) που ελέγχουν πώς μορφοποιείται η παραπομπή. FieldBibliography.SourceTag, FilterLanguageId, και FormatLanguageId ελέγχουν ποιες πηγές εμφανίζονται στη δημιουργημένη βιβλιογραφία και σε ποια γλώσσα. Η υποκείμενη πηγή καταγράφει αυτά τα πεδία που αποδίδονται – Source, Contributor, Person – καλύπτονται στο οδηγός βιβλιογραφίας.
Πεδία Κειμένου Παράθεσης και Σχήματος
FieldQuote (QUOTE) και FieldShape (SHAPE) εκθέτουν και οι δύο μια ιδιότητα Text που περιέχει κυριολεκτικό κείμενο πεδίου – FieldQuote το εισάγει άμεσα στη θέση του πεδίου, ενώ FieldShape το συσχετίζει με τον κώδικα πεδίου που φέρει κείμενο σε σχήμα σχεδίασης.
Συμβουλές και Καλές Πρακτικές
- Προτιμήστε το
DocumentBuilder.InsertHyperlink()για απλή εισαγωγή υπερσυνδέσμου· κατασκευάστε έναFieldHyperlinkαπευθείας μόνο όταν χρειάζεστε ιδιότητες όπως τοScreenTipή τοIsImageMapπου δεν εκτίθενται από τη συντόμευση του δημιουργού. FieldRef,FieldPageRef,FieldNoteRefκαιFieldSetσυντονίζονται όλα μέσωBookmarkName– βεβαιωθείτε ότι το στοχευόμενο σελιδοδείκτη υπάρχει (μέσωDocumentBuilder.StartBookmark()/EndBookmark()) πριν ενημερωθεί το πεδίο που το αναφέρει.- Ορίστε
FieldOptions.UserPromptRespondent(δείτε το οδηγός πεδίων) πριν από την ενημέρωση ενός εγγράφου που περιέχειFieldAskorFieldFillInπεδία σε μια αδιάβλεπτη γραμμή εργασίας. FieldDdeκαιFieldDdeAutoμοντελοποιούν έναν παλιό μηχανισμό σύνδεσης Windows OLE – θεωρήστε ταAutoUpdateκαιIsLinkedως πληροφοριακά κατά την επεξεργασία εγγράφων εκτός των Windows, επειδή η εξωτερική εφαρμογή από την οποία θα ανανεώνονταν κανονικά δεν είναι διαθέσιμη.- Τα πεδία παράθεσης και βιβλιογραφίας αποδίδονται σωστά μόνο όταν η υποκείμενη
Sourceυπάρχουν εγγραφές – δείτε το οδηγός βιβλιογραφίας για τη δημιουργία τους.
Συνηθισμένα Προβλήματα
| Πρόβλημα | Αιτία | Διόρθωση |
|---|---|---|
Το πεδίο REF / PAGEREF / NOTEREF εμφανίζει αποτέλεσμα σφάλματος | Το BookmarkName που στοχεύει δεν υπάρχει στο έγγραφο | Δημιουργήστε το σελιδοδείκτη με DocumentBuilder.StartBookmark() / EndBookmark() πριν την ενημέρωση του πεδίου |
Το πεδίο ASK / FILLIN εμποδίζει μια αυτόματη ενημέρωση | Δεν έχει ανατεθεί IFieldUserPromptRespondent | Αναθέστε FieldOptions.UserPromptRespondent, ή ορίστε DefaultResponse στο πεδίο |
Το πεδίο CITATION ή BIBLIOGRAPHY εμφανίζεται κενό | Το SourceTag δεν ταιριάζει με κανένα Source στα δεδομένα βιβλιογραφίας του εγγράφου | Προσθέστε το ταίριασμα Source – δείτε το οδηγός βιβλιογραφίας |
το πεδίο DDE / DDEAUTO / LINK δεν ανανεώνεται | Αυτά αναφέρονται σε μια εξωτερική πηγή OLE που δεν είναι διαθέσιμη στο τρέχον περιβάλλον | Αναμένεται εκτός του αρχικού πλαισίου Windows/OLE – αντιμετωπίστε το αποθηκευμένο Result ως την τελευταία γνωστή τιμή |
FAQ
Ποια είναι η διαφορά μεταξύ FieldRef και FieldStyleRef;
FieldRef αντιστοιχεί στο περιεχόμενο ενός ονομασμένου σελιδοδείκτη (BookmarkName); FieldStyleRef αντίθετα αντιστοιχεί στην πλησιέστερη παράγραφο που έχει μορφοποιηθεί με ένα δεδομένο StyleName, ανεξάρτητα από σελιδοδείκτες.
Πώς μπορώ να εισάγω έναν απλό υπερσύνδεσμο χωρίς να δημιουργήσω ένα Field με το χέρι;
Καλέστε DocumentBuilder.InsertHyperlink().
Αυτές οι κλάσεις πεδίων συνδέσμου και αναφοράς είναι σε ξεχωριστό namespace από άλλα πεδία;
Όχι – FieldHyperlink, FieldRef, FieldCitation, και οι υπόλοιπες κλάσεις σε αυτή τη σελίδα είναι συνηθισμένες Field υποκλάσεις στο Aspose.Words.Fields namespace, το ίδιο namespace που καλύπτεται στο οδηγός πεδίων.
Πώς σχετίζονται τα πεδία παραπομπής με το μοντέλο δεδομένων της βιβλιογραφίας;
FieldCitation and FieldBibliography αποδίδουν περιεχόμενο αναζητώντας SourceTag εναντίον του Source εγγραφές που περιγράφονται στο οδηγός βιβλιογραφίας – οι κλάσεις πεδίου διαχειρίζονται την απόδοση, και οι Source / Contributor οι κλάσεις περιέχουν τα υποκείμενα δεδομένα.
API Reference Σύνοψη
| Κλάση | Περιγραφή |
|---|---|
FieldHyperlink | HYPERLINK πεδίο; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF πεδία; επιλύστε το περιεχόμενο σε ένα BookmarkName |
FieldStyleRef | STYLEREF πεδίο; επιλύεται στην πλησιέστερη παράγραφο σε ένα δεδομένο στυλ |
FieldSet | SET πεδίο; ορίζει μια τιμή κειμένου σε σελιδοδείκτη για το REF ώστε να επιλυθεί |
FieldAsk / FieldFillIn | ASK / FILLIN πεδία; ζητούν τιμή κατά την ενημέρωση |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK πεδία; παλαιό εξωτερικό περιεχόμενο συνδεδεμένο μέσω OLE |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE πεδία; εξωτερικό γραφικό περιεχόμενο |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT πεδία; εξωτερικό έγγραφο ή XML περιεχόμενο |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY πεδία; αναφορά σε καταχωρήσεις δομικών μονάδων |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY πεδία· απόδοση δεδομένων πηγής βιβλιογραφίας |
FieldQuote / FieldShape | QUOTE / SHAPE πεδία· κυριολεκτικό κείμενο πεδίου |
DocumentBuilder.InsertHyperlink | Συντόμευση εισαγωγής υπερσύνδεσμου υψηλού επιπέδου |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Δημιουργία σελιδοδείκτη και πλοήγηση για στόχους αναφοράς |