Travailler avec les liens et les références

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’un FieldHyperlink uniquement lorsque vous avez besoin de propriétés telles que ScreenTip ou IsImageMap que le raccourci du constructeur n’expose pas.
  • FieldRef, FieldPageRef, FieldNoteRef et FieldSet se coordonnent tous via BookmarkName — assurez-vous que le signet cible existe (via DocumentBuilder.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 contenant FieldAsk or FieldFillIn des champs dans un pipeline non supervisé.
  • FieldDde et FieldDdeAuto modélisent un mécanisme de liaison OLE Windows hérité — considérez AutoUpdate et IsLinked comme 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 Source les enregistrements existent – voir le guide bibliographique pour les créer.

Problèmes courants

ProblèmeCauseCorrection
Le champ REF / PAGEREF / NOTEREF affiche un résultat d’erreurLe BookmarkName ciblé n’existe pas dans le documentCréez le signet avec DocumentBuilder.StartBookmark() / EndBookmark() avant de mettre à jour le champ
Le champ ASK / FILLIN bloque une mise à jour non superviséeAucun IFieldUserPromptRespondent n’est attribuéAttribuez FieldOptions.UserPromptRespondent, ou définissez DefaultResponse sur le champ
Le champ CITATION ou BIBLIOGRAPHY apparaît videLe SourceTag ne correspond à aucun Source dans les données bibliographiques du documentAjoutez la correspondance Source – voir le guide de bibliographie
DDE / DDEAUTO / LINK le champ ne se rafraîchit pasCes références proviennent d’une source OLE externe qui n’est pas disponible dans l’environnement actuelAttendu 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é

ClasseDescription
FieldHyperlinkHYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefchamps REF / PAGEREF / NOTEREF ; résoudre le contenu à un BookmarkName
FieldStyleRefchamp STYLEREF ; se résout au paragraphe le plus proche dans un style donné
FieldSetchamp SET ; définit une valeur de texte bookmarkée pour REF à résoudre
FieldAsk / FieldFillInchamps ASK / FILLIN ; invite à saisir une valeur lors de la mise à jour
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK champs ; contenu externe lié OLE hérité
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE champs ; contenu graphique externe
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT champs ; document externe ou contenu XML
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY champs ; entrées de blocs de construction de référence
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY champs ; rendre les données sources de la bibliographie
FieldQuote / FieldShapeQUOTE / SHAPE champs ; texte de champ littéral
DocumentBuilder.InsertHyperlinkRaccourci d’insertion de lien hypertexte de haut niveau
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkCréation de signet et navigation pour les cibles de référence

Voir aussi

 Français