Werken met koppelingen en referenties
Werken met koppelingen en verwijzingen
Word’s link- en kruisverwijzingsveldcodes – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, en meer – worden elk geïmplementeerd als een toegewijde Field subklasse in Aspose.Words FOSS for .NET. Al deze klassen bevinden zich in de Aspose.Words.Fields namespace naast elk ander veldtype; deze pagina groepeert de velden die specifiek betrekking hebben op links, kruisverwijzingen, opgegeven waarden en citaten, en beschrijft wat elk van hen blootlegt.
Hyperlinks
FieldHyperlink vertegenwoordigt het HYPERLINK veld: Address en SubAddress bevatten de doel-URL of locatie in het document, ScreenTip stelt de zweeftooltip in, OpenInNewWindow en IsImageMap zijn weergavevlaggen, en Target geeft een browserframe een naam. Voor eenvoudige gevallen voegt DocumentBuilder.InsertHyperlink() een hyperlinkveld direct in zonder handmatig het Field object te construeren.
Kruisverwijzingen naar bladwijzers
FieldRef (het REF veld), FieldPageRef (PAGEREF), en FieldNoteRef (NOTEREF) lossen elk op naar inhoud op een benoemde bladwijzer via hun BookmarkName eigenschap, waarbij InsertHyperlink en InsertRelativePosition bepalen of de verwijzing klikbaar is en of deze een relatieve positie rapporteert (“boven” / “onder”). FieldRef voegt alinea-nummeringsopties toe (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) en IncludeNoteOrComment. FieldStyleRef (STYLEREF) lost in plaats daarvan op naar de dichtstbijzijnde alinea die is opgemaakt met een gegeven StyleName, met SearchFromBottom om achterwaarts te zoeken vanaf de positie van het veld. De bladwijzers die deze velden targeten worden gemaakt met DocumentBuilder.StartBookmark() en EndBookmark(), en kunnen worden genavigeerd met MoveToBookmark(). FieldSet (SET) definieert een gebookmarkte tekstwaarde – BookmarkName en BookmarkText – die een REF veld elders kan oplossen.
Opgevraagde-waarde velden
FieldAsk (ASK) en FieldFillIn (FILLIN) vraagt een waarde op van degene die het veld bijwerkt: PromptText wordt getoond aan de gebruiker, DefaultResponse levert een fallback, en PromptOnceOnMailMerge beperkt herhaalde prompts tijdens een mail merge. FieldAsk slaat bovendien zijn antwoord op op BookmarkName zodat andere velden ernaar kunnen verwijzen. Zie de veldenhandleiding for IFieldUserPromptRespondent, de callback die antwoorden op deze velden programmeermatig levert in plaats van interactief te prompten.
Externe en gekoppelde inhoud
FieldDde (DDE) en FieldDdeAuto (DDEAUTO) koppelen naar inhoud in een andere applicatie via ProgId, SourceFullName en SourceItem, waarbij InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode en InsertAsBitmap de ingevoegde weergave selecteren, en AutoUpdate / IsLinked het verversingsgedrag regelen. FieldLink (LINK) is het OLE-link-equivalent en voegt FormatUpdateType toe. FieldImport (IMPORT) en FieldIncludePicture (INCLUDEPICTURE) halen een externe afbeelding op via SourceFullName en GraphicFilter. FieldInclude (INCLUDE) en FieldIncludeText (INCLUDETEXT) halen externe documentinhoud op, met BookmarkName om het opgenomen bereik te bepalen en LockFields om te voorkomen dat het wordt ververst; FieldIncludeText ondersteunt bovendien XML-bronnen via Encoding, MimeType, NamespaceMappings, XPath en XslTransformation.
AutoText en Glossariumverwijzingen
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) en FieldGlossary (GLOSSARY) refereren allemaal aan een benoemde bouw-blok entry via EntryName; FieldAutoTextList voegt ListStyle en ScreenTip toe voor zijn lijst-stijl presentatie.
Citaat- en bibliografievelden
FieldCitation (CITATION) en FieldBibliography (BIBLIOGRAPHY) render inhoud afkomstig van de bibliografische gegevens van het document. FieldCitation.SourceTag (en het alternatieve AnotherSourceTag) identificeert welke bron het citeert, met Prefix, Suffix, PageNumber, VolumeNumber, en de Suppress* vlaggen (SuppressAuthor, SuppressTitle, SuppressYear) die bepaalt hoe de citaat wordt opgemaakt. FieldBibliography.SourceTag, FilterLanguageId, en FormatLanguageId beheersen welke bronnen verschijnen in de gerenderde bibliografie en in welke taal. De onderliggende bron registreert deze velden render – Source, Contributor, Person – worden behandeld in de bibliografiehandleiding.
Citaat- en vormtekstvelden
FieldQuote (QUOTE) en FieldShape (SHAPE) bieden beide een Text eigenschap die letterlijke veldtekst bevat – FieldQuote voegt deze direct in op de positie van het veld, terwijl FieldShape het koppelt aan de veldcode van een tekstelement in een tekenvorm.
Tips en best practices
- Geef de voorkeur aan
DocumentBuilder.InsertHyperlink()voor eenvoudige hyperlinkinvoeging; ga pas over tot het rechtstreeks construeren van eenFieldHyperlinkalleen wanneer je eigenschappen nodig hebt zoalsScreenTipofIsImageMapdie de bouwersnelkoppeling niet blootstelt. FieldRef,FieldPageRef,FieldNoteRefenFieldSetcoördineren allemaal viaBookmarkName– zorg ervoor dat de doelbookmark bestaat (viaDocumentBuilder.StartBookmark()/EndBookmark()) voordat het veld dat ernaar verwijst wordt bijgewerkt.- Instellen
FieldOptions.UserPromptRespondent(zie de veldenhandleiding) voordat een document wordt bijgewerkt datFieldAskorFieldFillInvelden in een onbeheerde pipeline. FieldDdeenFieldDdeAutomodelleren een legacy Windows OLE-koppelingsmechanisme – beschouwAutoUpdateenIsLinkedals informatief bij het verwerken van documenten buiten Windows, omdat de externe toepassing waarvan ze normaal zouden vernieuwen niet beschikbaar is.- Citaat- en bibliografievelden worden pas correct weergegeven zodra de document’s onderliggende
Sourcerecords bestaan – zie de bibliografiegids voor het bouwen daarvan.
Veelvoorkomende problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
Veld REF / PAGEREF / NOTEREF toont een foutresultaat | De BookmarkName waarnaar wordt verwezen, bestaat niet in het document | Maak de bladwijzer met DocumentBuilder.StartBookmark() / EndBookmark() aan voordat het veld wordt bijgewerkt |
Veld ASK / FILLIN blokkeert een onbemand update | Er is geen IFieldUserPromptRespondent toegewezen | Wijs FieldOptions.UserPromptRespondent toe, of stel DefaultResponse in op het veld |
CITATION of BIBLIOGRAPHY veld wordt leeg weergegeven | De SourceTag komt niet overeen met een Source in de bibliografische gegevens van het document | Voeg de overeenkomst toe Source – zie de bibliografiegids |
DDE / DDEAUTO / LINK veld wordt niet ververst | Deze verwijzen naar een externe OLE-bron die niet beschikbaar is in de huidige omgeving | Verwacht buiten de oorspronkelijke Windows/OLE-context – behandel de opgeslagen Result als de laatst bekende waarde |
FAQ
Wat is het verschil tussen FieldRef en FieldStyleRef?
FieldRef verwijst naar inhoud op een benoemde bladwijzer (BookmarkName); FieldStyleRef verwijst daarentegen naar de dichtstbijzijnde alinea die is opgemaakt met een gegeven StyleName, onafhankelijk van bladwijzers.
Hoe voeg ik een eenvoudige hyperlink in zonder handmatig een Field te bouwen?
Roep DocumentBuilder.InsertHyperlink() aan.
Zijn deze link- en referentieveldklassen in een aparte namespace van andere velden?
Nee – FieldHyperlink, FieldRef, FieldCitation, en de rest van de klassen op deze pagina zijn gewoon Field subklassen in de Aspose.Words.Fields namespace, dezelfde namespace behandeld in de veldenhandleiding.
Hoe verhouden citatievelden zich tot het bibliografische datamodel?
FieldCitation and FieldBibliography render inhoud door op te zoeken SourceTag tegen de Source records beschreven op de bibliografiehandleiding – de veldklassen behandelen weergave, en de Source / Contributor klassen bevatten de onderliggende gegevens.
API Reference Samenvatting
| Klasse | Beschrijving |
|---|---|
FieldHyperlink | HYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF fields; los inhoud op bij een BookmarkName |
FieldStyleRef | STYLEREF veld; lost op naar de dichtstbijzijnde alinea in een gegeven stijl |
FieldSet | SET veld; definieert een bladwijzer-tekstwaarde voor REF om op te lossen |
FieldAsk / FieldFillIn | ASK / FILLIN velden; vraagt om een waarde tijdens het bijwerken |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK velden; legacy OLE-gekoppelde externe inhoud |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE velden; externe grafische inhoud |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT velden; extern document of XML inhoud |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY velden; referentie bouwblokvermeldingen |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY velden; weergave bibliografie brongegevens |
FieldQuote / FieldShape | QUOTE / SHAPE velden; letterlijke veldtekst |
DocumentBuilder.InsertHyperlink | Sneltoets voor het invoegen van hyperlinks op hoog niveau |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Bladwijzercreatie en navigatie voor referentiedoelen |