Travailler avec les liens et les références
Vue d’ensemble
Les codes de champ de lien et de renvoi croisé de Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, et plus encore – sont chacun implémentés comme un dédié Field sous-classe dans Aspose.Words FOSS pour .NET. Toutes ces classes résident dans le Aspose.Words.Fields espace de noms aux côtés de chaque autre type de champ ; cette page regroupe celles qui concernent spécifiquement les liens, les renvois croisés, les valeurs sollicitées et les citations, et décrit ce que chacune expose.
Hyperlinks
FieldHyperlink représente le champ HYPERLINK: Address et SubAddress contiennent l’URL cible ou l’emplacement dans le document, ScreenTip définit l’infobulle au survol, OpenInNewWindow et IsImageMap sont des indicateurs d’affichage, et Target nomme un cadre de navigateur. Pour les cas simples, DocumentBuilder.InsertHyperlink() insère directement un champ hyperlien sans construire manuellement l’objet Field.
Renvois croisés vers les signets
FieldRef (le champ REF), FieldPageRef (PAGEREF) et FieldNoteRef (NOTEREF) résolvent chacun le contenu d’un signet nommé via leur propriété BookmarkName, InsertHyperlink et InsertRelativePosition contrôlant respectivement si la référence est cliquable et si elle indique une position relative («au-dessus» / «en-dessous»). FieldRef ajoute des options de numérotation de paragraphe (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) ainsi que IncludeNoteOrComment. FieldStyleRef (STYLEREF) résout à la place le paragraphe le plus proche formaté avec un StyleName donné, avec SearchFromBottom pour rechercher en arrière depuis la position du champ. Les signets ciblés par ces champs sont créés avec DocumentBuilder.StartBookmark() et EndBookmark(), et on peut s’y rendre avec MoveToBookmark(). FieldSet (SET) définit une valeur de texte signet – BookmarkName et BookmarkText – qu’un champ REF ailleurs peut résoudre.
Champs à valeur sollicitée
FieldAsk (ASK) et FieldFillIn (FILLIN) demandent une valeur à quiconque met à jour le champ : PromptText est affiché à l’utilisateur, DefaultResponse fournit une solution de secours, et PromptOnceOnMailMerge limite les invites répétées lors d’une fusion de courrier. FieldAsk stocke également sa réponse à BookmarkName pour que d’autres champs s’y réfèrent. Voir le guide des champs for IFieldUserPromptRespondent, le rappel qui fournit des réponses à ces champs de manière programmatique au lieu de les demander interactivement.
Contenu externe et lié
FieldDde (DDE) et FieldDdeAuto (DDEAUTO) créent un lien vers du contenu dans une autre application via ProgId, SourceFullName et SourceItem, InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode et InsertAsBitmap sélectionnant la représentation insérée, et AutoUpdate / IsLinked contrôlant le comportement de rafraîchissement. FieldLink (LINK) est l’équivalent du lien OLE, ajoutant FormatUpdateType. FieldImport (IMPORT) et FieldIncludePicture (INCLUDEPICTURE) importent un graphique externe via SourceFullName et GraphicFilter. FieldInclude (INCLUDE) et FieldIncludeText (INCLUDETEXT) importent du contenu de document externe, avec BookmarkName pour délimiter la plage incluse et LockFields pour empêcher son rafraîchissement ; FieldIncludeText prend également en charge les sources XML via Encoding, MimeType, NamespaceMappings, XPath et XslTransformation.
AutoText et références du glossaire
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) et FieldGlossary (GLOSSARY) font tous référence à une entrée de bloc de construction nommée via EntryName ; FieldAutoTextList ajoute ListStyle et ScreenTip pour sa présentation sous forme de liste.
Champs de citation et de bibliographie
FieldCitation (CITATION) et FieldBibliography (BIBLIOGRAPHY) rend le contenu provenant des données de bibliographie du document. FieldCitation.SourceTag (et l’alternative AnotherSourceTag) identifie la source qu’il cite, avec Prefix, Suffix, PageNumber, VolumeNumber, et le Suppress* indicateurs (SuppressAuthor, SuppressTitle, SuppressYear) contrôlant la façon dont la citation est formatée. FieldBibliography.SourceTag, FilterLanguageId, et FormatLanguageId contrôlent quelles sources apparaissent dans la bibliographie rendue et dans quelle langue. Les enregistrements source sous-jacents rendent ces champs – Source, Contributor, Person – sont couverts dans le guide de bibliographie.
Champs de texte de citation et de forme
FieldQuote (QUOTE) et FieldShape (SHAPE) exposent tous deux une propriété Text contenant du texte de champ littéral – FieldQuote l’insère directement à la position du champ, tandis que FieldShape l’associe au code de champ portant du texte d’une forme de dessin.
Conseils et meilleures pratiques
- Privilégiez
DocumentBuilder.InsertHyperlink()pour l’insertion simple d’hyperlien; passez à la construction directe d’unFieldHyperlinkuniquement lorsque vous avez besoin de propriétés telles queScreenTipouIsImageMapque le raccourci du constructeur n’expose pas. FieldRef,FieldPageRef,FieldNoteRefetFieldSetse coordonnent tous viaBookmarkName— assurez-vous que le signet cible existe (viaDocumentBuilder.StartBookmark()/EndBookmark()) avant que le champ qui y fait référence ne soit mis à jour.- Définir
FieldOptions.UserPromptRespondent(voir le guide des champs) avant de mettre à jour un document contenantFieldAskorFieldFillIndes champs dans un pipeline non supervisé. FieldDdeetFieldDdeAutomodélisent un mécanisme de liaison OLE Windows hérité — considérezAutoUpdateetIsLinkedcomme informatifs lors du traitement de documents hors Windows, car l’application externe dont ils se rafraîchiraient normalement n’est pas disponible.- Les champs de citation et de bibliographie ne s’affichent correctement qu’une fois le sous-jacent du document
Sourceles enregistrements existent – voir le guide bibliographique pour les créer.
Problèmes courants
| Problème | Cause | Correction |
|---|---|---|
Le champ REF / PAGEREF / NOTEREF affiche un résultat d’erreur | Le BookmarkName ciblé n’existe pas dans le document | Créez le signet avec DocumentBuilder.StartBookmark() / EndBookmark() avant de mettre à jour le champ |
Le champ ASK / FILLIN bloque une mise à jour non supervisée | Aucun IFieldUserPromptRespondent n’est attribué | Attribuez FieldOptions.UserPromptRespondent, ou définissez DefaultResponse sur le champ |
Le champ CITATION ou BIBLIOGRAPHY apparaît vide | Le SourceTag ne correspond à aucun Source dans les données bibliographiques du document | Ajoutez la correspondance Source – voir le guide de bibliographie |
DDE / DDEAUTO / LINK le champ ne se rafraîchit pas | Ces références proviennent d’une source OLE externe qui n’est pas disponible dans l’environnement actuel | Attendu en dehors du contexte Windows/OLE d’origine – traiter le Result stocké comme la dernière valeur connue |
FAQ
Quelle est la différence entre FieldRef et FieldStyleRef?
FieldRef se résout au contenu d’un signet nommé (BookmarkName); FieldStyleRef, en revanche, se résout au paragraphe le plus proche formaté avec un StyleName donné, indépendamment des signets.
Comment insérer un lien hypertexte simple sans créer un Field manuellement?
Appelez DocumentBuilder.InsertHyperlink().
Ces classes de champs lien et référence se trouvent-elles dans un espace de noms séparé des autres champs?
Non – FieldHyperlink, FieldRef, FieldCitation, et le reste des classes sur cette page sont ordinaires Field sous-classes dans le Aspose.Words.Fields espace de noms, le même espace de noms couvert dans le guide des champs.
Comment les champs de citation se rapportent-ils au modèle de données de la bibliographie?
FieldCitation and FieldBibliography rendre le contenu en recherchant SourceTag contre le Source les enregistrements décrits dans le guide de bibliographie – les classes de champ gèrent le rendu, et le Source / Contributor les classes contiennent les données sous-jacentes.
API Reference Résumé
| Classe | Description |
|---|---|
FieldHyperlink | HYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | champs REF / PAGEREF / NOTEREF ; résoudre le contenu à un BookmarkName |
FieldStyleRef | champ STYLEREF ; se résout au paragraphe le plus proche dans un style donné |
FieldSet | champ SET ; définit une valeur de texte bookmarkée pour REF à résoudre |
FieldAsk / FieldFillIn | champs ASK / FILLIN ; invite à saisir une valeur lors de la mise à jour |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK champs ; contenu externe lié OLE hérité |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE champs ; contenu graphique externe |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT champs ; document externe ou contenu XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY champs ; entrées de blocs de construction de référence |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY champs ; rendre les données sources de la bibliographie |
FieldQuote / FieldShape | QUOTE / SHAPE champs ; texte de champ littéral |
DocumentBuilder.InsertHyperlink | Raccourci d’insertion de lien hypertexte de haut niveau |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Création de signet et navigation pour les cibles de référence |