Lavorare con collegamenti e riferimenti
Panoramica
I codici di campo di collegamento e di riferimento incrociato di Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, e altro – sono ciascuno implementati come una sottoclasse dedicata Field sottoclasse in Aspose.Words FOSS per .NET. Tutte queste classi vivono nel Aspose.Words.Fields namespace insieme a tutti gli altri tipi di campo; questa pagina raggruppa quelli specificamente relativi a collegamenti, riferimenti incrociati, valori richiesti e citazioni, e descrive ciò che ciascuno espone.
Hyperlinks
FieldHyperlink rappresenta il campo HYPERLINK: Address e SubAddress contengono l’URL di destinazione o la posizione all’interno del documento, ScreenTip imposta il tooltip al passaggio del mouse, OpenInNewWindow e IsImageMap sono flag di visualizzazione, e Target denomina un frame del browser. Nei casi semplici, DocumentBuilder.InsertHyperlink() inserisce direttamente un campo hyperlink senza costruire manualmente l’oggetto Field.
Riferimenti incrociati ai segnalibri
FieldRef (il campo REF), FieldPageRef (PAGEREF) e FieldNoteRef (NOTEREF) risolvono tutti al contenuto di un segnalibro denominato tramite la loro proprietà BookmarkName, con InsertHyperlink e InsertRelativePosition che controllano se il riferimento è cliccabile e se riporta una posizione relativa (“sopra” / “sotto”). FieldRef aggiunge opzioni di numerazione dei paragrafi (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) e IncludeNoteOrComment. FieldStyleRef (STYLEREF) invece risolve al paragrafo più vicino formattato con un determinato StyleName, con SearchFromBottom per cercare all’indietro dalla posizione del campo. I segnalibri a cui puntano questi campi sono creati con DocumentBuilder.StartBookmark() e EndBookmark(), e possono essere raggiunti con MoveToBookmark(). FieldSet (SET) definisce un valore di testo segnalato – BookmarkName e BookmarkText – che un campo REF altrove può risolvere.
Campi di valore richiesto
FieldAsk (ASK) e FieldFillIn (FILLIN) richiedono un valore a chiunque aggiorni il campo: PromptText viene mostrato all’utente, DefaultResponse fornisce un fallback, e PromptOnceOnMailMerge limita i prompt ripetuti durante un mail merge. FieldAsk memorizza inoltre la sua risposta in BookmarkName per altri campi da riferire. Vedi il guida ai campi for IFieldUserPromptRespondent, il callback che fornisce risposte a questi campi in modo programmatico invece di richiedere interattivamente.
Contenuto esterno e collegato
FieldDde (DDE) e FieldDdeAuto (DDEAUTO) collegano a contenuti in un’altra applicazione tramite ProgId, SourceFullName e SourceItem, con InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode e InsertAsBitmap che selezionano la rappresentazione inserita, e AutoUpdate / IsLinked che controllano il comportamento di aggiornamento. FieldLink (LINK) è l’equivalente del collegamento OLE, aggiungendo FormatUpdateType. FieldImport (IMPORT) e FieldIncludePicture (INCLUDEPICTURE) inseriscono un’immagine esterna tramite SourceFullName e GraphicFilter. FieldInclude (INCLUDE) e FieldIncludeText (INCLUDETEXT) inseriscono contenuto di documento esterno, con BookmarkName per delimitare l’intervallo incluso e LockFields per impedirne l’aggiornamento; FieldIncludeText supporta inoltre fonti XML attraverso Encoding, MimeType, NamespaceMappings, XPath e XslTransformation.
AutoText e riferimenti al glossario
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) e FieldGlossary (GLOSSARY) fanno tutti riferimento a una voce di blocco di costruzione denominata tramite EntryName; FieldAutoTextList aggiunge ListStyle e ScreenTip per la sua presentazione in stile elenco.
Campi di citazione e bibliografia
FieldCitation (CITATION) e FieldBibliography (BIBLIOGRAPHY) genera contenuto proveniente dai dati della bibliografia del documento. FieldCitation.SourceTag (e l’alternativa AnotherSourceTag) identifica quale fonte cita, con Prefix, Suffix, PageNumber, VolumeNumber, e il Suppress* flag (SuppressAuthor, SuppressTitle, SuppressYear) controllano come viene formattata la citazione. FieldBibliography.SourceTag, FilterLanguageId, e FormatLanguageId controllano quali fonti appaiono nella bibliografia resa e in quale lingua. La fonte sottostante registra questi campi render – Source, Contributor, Person – sono trattati in guida alla bibliografia.
Campi di testo per citazioni e forme
FieldQuote (QUOTE) e FieldShape (SHAPE) espongono entrambi una proprietà Text che contiene testo letterale del campo – FieldQuote lo inserisce direttamente nella posizione del campo, mentre FieldShape lo associa al codice di campo portatore di testo di una forma disegnata.
Suggerimenti e migliori pratiche
- Preferisci
DocumentBuilder.InsertHyperlink()per l’inserimento semplice di hyperlink; ricorri alla costruzione diretta di unFieldHyperlinksolo quando hai bisogno di proprietà comeScreenTipoIsImageMapche la scorciatoia del costruttore non espone. FieldRef,FieldPageRef,FieldNoteRefeFieldSetsi coordinano tutti tramiteBookmarkName– assicurati che il segnalibro di destinazione esista (tramiteDocumentBuilder.StartBookmark()/EndBookmark()) prima che il campo che lo riferisce venga aggiornato.- Imposta
FieldOptions.UserPromptRespondent(vedi la guida ai campi) prima di aggiornare un documento contenenteFieldAskorFieldFillIncampi in una pipeline non supervisionata. FieldDdeeFieldDdeAutomodellano un meccanismo di collegamento OLE legacy di Windows – trattaAutoUpdateeIsLinkedcome informativi quando elabori documenti al di fuori di Windows, poiché l’applicazione esterna da cui normalmente si aggiornerebbero non è disponibile.- I campi di citazione e bibliografia vengono renderizzati correttamente solo una volta che il documento sottostante
Sourcei record esistono – vedi il guida bibliografica per crearli.
Problemi comuni
| Problema | Causa | Correzione |
|---|---|---|
Il campo REF / PAGEREF / NOTEREF mostra un risultato di errore | Il BookmarkName a cui fa riferimento non esiste nel documento | Crea il segnalibro con DocumentBuilder.StartBookmark() / EndBookmark() prima di aggiornare il campo |
Il campo ASK / FILLIN blocca un aggiornamento automatico | Nessun IFieldUserPromptRespondent è assegnato | Assegna FieldOptions.UserPromptRespondent, oppure imposta DefaultResponse sul campo |
Il campo CITATION o BIBLIOGRAPHY risulta vuoto | Il SourceTag non corrisponde a nessun Source nei dati della bibliografia del documento | Aggiungi la corrispondenza Source – vedi il guida bibliografica |
Il campo DDE / DDEAUTO / LINK non si aggiorna | Questi fanno riferimento a una sorgente OLE esterna non disponibile nell’ambiente corrente | Previsto al di fuori del contesto originale Windows/OLE – considera il Result memorizzato come l’ultimo valore noto |
FAQ
Qual è la differenza tra FieldRef e FieldStyleRef?
FieldRef restituisce il contenuto di un segnalibro denominato (BookmarkName); FieldStyleRef invece restituisce il paragrafo più vicino formattato con un dato StyleName, indipendente dai segnalibri.
Come inserire un semplice collegamento ipertestuale senza creare manualmente un Field?
Chiama DocumentBuilder.InsertHyperlink().
Queste classi di campi di collegamento e riferimento si trovano in uno spazio dei nomi separato rispetto agli altri campi?
No – FieldHyperlink, FieldRef, FieldCitation, e il resto delle classi in questa pagina è ordinario Field sottoclassi in the Aspose.Words.Fields namespace, lo stesso namespace coperto nel guida dei campi.
Come si relazionano i campi di citazione al modello dati della bibliografia?
FieldCitation and FieldBibliography renderizzare il contenuto cercando SourceTag contro il Source record descritti sul guida bibliografica – le classi di campo gestiscono il rendering, e le Source / Contributor classi contengono i dati sottostanti.
API Reference Riepilogo
| Classe | Descrizione |
|---|---|
FieldHyperlink | HYPERLINK campo; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF campi; risolvi il contenuto a un BookmarkName |
FieldStyleRef | STYLEREF campo; si risolve nel paragrafo più vicino in uno stile dato |
FieldSet | SET campo; definisce un valore di testo contrassegnato per REF da risolvere |
FieldAsk / FieldFillIn | ASK / FILLIN campi; richiedi un valore durante l’aggiornamento |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK campi; contenuto esterno legacy collegato OLE |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE campi; contenuto grafico esterno |
FieldInclude / FieldIncludeText | campi INCLUDE / INCLUDETEXT; documento esterno o contenuto XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | campi AUTOTEXT / AUTOTEXTLIST / GLOSSARY; voci di riferimento dei blocchi costitutivi |
FieldCitation / FieldBibliography | campi CITATION / BIBLIOGRAPHY; generare i dati sorgente della bibliografia |
FieldQuote / FieldShape | campi QUOTE / SHAPE; testo letterale del campo |
DocumentBuilder.InsertHyperlink | Scorciatoia per l’inserimento di hyperlink di alto livello |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Creazione e navigazione di segnalibri per i target di riferimento |