Arbeta med länkar och referenser

Arbeta med länkar och referenser

Översikt

Word’s länk- och korsreferenskodfält – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, och mer – implementeras var och en som en dedikerad Field subklass i Aspose.Words FOSS för .NET. Alla dessa klasser finns i Aspose.Words.Fields namnrymden tillsammans med alla andra fälttyper; den här sidan grupperar de som specifikt rör länkar, korsreferenser, uppmanade värden och citat, och beskriver vad var och en exponerar.


Hyperlinks

FieldHyperlink representerar HYPERLINK-fältet: Address och SubAddress innehåller mål-URL:en eller platsen i dokumentet, ScreenTip anger verktygstipset vid hovring, OpenInNewWindow och IsImageMap är visningsflaggor, och Target namnger en webbläsarram. För enkla fall infogar DocumentBuilder.InsertHyperlink() ett hyperlänkfält direkt utan att konstruera Field-objektet för hand.


Korsreferenser till bokmärken

FieldRef (fältet REF), FieldPageRef (PAGEREF) och FieldNoteRef (NOTEREF) löser var för sig upp till innehåll vid ett namngivet bokmärke via deras BookmarkName-egenskap, där InsertHyperlink och InsertRelativePosition styr om referensen är klickbar och om den rapporterar en relativ position (“ovan” / “nedan”). FieldRef lägger till alternativ för styckesnumrering (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) och IncludeNoteOrComment. FieldStyleRef (STYLEREF) löser i stället till det närmaste stycket som är formaterat med ett givet StyleName, med SearchFromBottom för att söka bakåt från fältets position. Bokmärkena som dessa fält pekar på skapas med DocumentBuilder.StartBookmark() och EndBookmark(), och kan navigeras till med MoveToBookmark(). FieldSet (SET) definierar ett bokmärkt textvärde – BookmarkName och BookmarkText – som ett REF-fält någon annanstans kan lösa.


Uppmanade värdefält

FieldAsk (ASK) och FieldFillIn (FILLIN) begär ett värde från den som uppdaterar fältet: PromptText visas för användaren, DefaultResponse tillhandahåller en reserv, och PromptOnceOnMailMerge begränsar upprepade uppmaningar under en mail merge. FieldAsk lagrar dessutom sitt svar på BookmarkName så att andra fält kan referera till det. Se fältguide for IFieldUserPromptRespondent, återanropet som levererar svar till dessa fält programmässigt istället för att fråga interaktivt.


Externt och länkat innehåll

FieldDde (DDE) och FieldDdeAuto (DDEAUTO) länkar till innehåll i en annan applikation via ProgId, SourceFullName och SourceItem, där InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode och InsertAsBitmap väljer den infogade representationen, och AutoUpdate / IsLinked styr uppdateringsbeteendet. FieldLink (LINK) är OLE-länkens motsvarighet och lägger till FormatUpdateType. FieldImport (IMPORT) och FieldIncludePicture (INCLUDEPICTURE) hämtar en extern grafik via SourceFullName och GraphicFilter. FieldInclude (INCLUDE) och FieldIncludeText (INCLUDETEXT) hämtar externt dokumentinnehåll, med BookmarkName för att avgränsa det inkluderade intervallet och LockFields för att förhindra att det uppdateras; FieldIncludeText stödjer dessutom XML-källor via Encoding, MimeType, NamespaceMappings, XPath och XslTransformation.


AutoText och ordlistereferenser

FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) och FieldGlossary (GLOSSARY) refererar alla till en namngiven byggblockspost via EntryName; FieldAutoTextList lägger till ListStyle och ScreenTip för dess liststilspresentation.


Citations- och bibliografifält

FieldCitation (CITATION) och FieldBibliography (BIBLIOGRAPHY) rendera innehåll hämtat från dokumentets bibliografidata. FieldCitation.SourceTag (och det alternativa AnotherSourceTag) identifierar vilken källa den citerar, med Prefix, Suffix, PageNumber, VolumeNumber, och den Suppress* flaggor (SuppressAuthor, SuppressTitle, SuppressYear) som styr hur citatet formateras. FieldBibliography.SourceTag, FilterLanguageId, och FormatLanguageId kontrollerar vilka källor som visas i den renderade bibliografin och på vilket språk. Den underliggande källan registrerar dessa fält renderar – Source, Contributor, Person – täcks i bibliografiguide.


Citat- och formtextfält

FieldQuote (QUOTE) och FieldShape (SHAPE) exponerar båda en Text egenskap som innehåller bokstavlig fälttext – FieldQuote infogar den direkt på fältets position, medan FieldShape associerar den med en ritningsforms textbärande fältkod.


Tips och bästa praxis

  • Föredra DocumentBuilder.InsertHyperlink() för enkel hyperlänksinfogning; gå ner till att konstruera en FieldHyperlink direkt endast när du behöver egenskaper såsom ScreenTip eller IsImageMap som byggarens genväg inte exponerar.
  • FieldRef, FieldPageRef, FieldNoteRef och FieldSet koordinerar alla via BookmarkName – se till att målbokmärket finns (via DocumentBuilder.StartBookmark() / EndBookmark()) innan fältet som refererar till det uppdateras.
  • Sätt FieldOptions.UserPromptRespondent (se fältguide) innan du uppdaterar ett dokument som innehåller FieldAsk or FieldFillIn fält i en oövervakad pipeline.
  • FieldDde och FieldDdeAuto modellerar en äldre Windows OLE-länkningsmekanism – behandla AutoUpdate och IsLinked som informativa när du bearbetar dokument utanför Windows, eftersom den externa applikation de normalt skulle uppdatera från inte är tillgänglig.
  • Citations- och bibliografifält renderas korrekt först när dokumentets underliggande Source poster finns – se bibliografiguide för att bygga dem.

Vanliga problem

ProblemOrsakÅtgärd
REF / PAGEREF / NOTEREF fältet visar ett felresultatDet BookmarkName som den riktar mot finns inte i dokumentetSkapa bokmärket med DocumentBuilder.StartBookmark() / EndBookmark() innan du uppdaterar fältet
ASK / FILLIN fältet blockerar en obevakad uppdateringIngen IFieldUserPromptRespondent har tilldelatsTilldela FieldOptions.UserPromptRespondent, eller ange DefaultResponse på fältet
CITATION eller BIBLIOGRAPHY fältet visas tomtSourceTag matchar inte någon Source i dokumentets bibliografidataLägg till den matchande Source – se bibliografiguide
DDE / DDEAUTO / LINK fältet uppdateras inteDessa refererar till en extern OLE-källa som inte är tillgänglig i den aktuella miljönFörväntas utanför den ursprungliga Windows/OLE-kontexten – behandla det lagrade Result som det senast kända värdet

FAQ

Vad är skillnaden mellan FieldRef och FieldStyleRef?

FieldRef löser upp till innehåll vid ett namngivet bokmärke (BookmarkName); FieldStyleRef löser däremot upp till det närmaste stycket som är formaterat med en given StyleName, oberoende av bokmärken.

Hur kan jag infoga en enkel hyperlänk utan att bygga en Field för hand?

Anropa DocumentBuilder.InsertHyperlink().

Är dessa länk- och referensfältklasser i ett separat namnrymd från andra fält?

Nej – FieldHyperlink, FieldRef, FieldCitation, och resten av klasserna på den här sidan är vanliga Field underklasser i Aspose.Words.Fields namnrymden, samma namnrymd som behandlas i fältguide.

Hur relaterar citeringsfält till bibliografimodellen?

FieldCitation and FieldBibliography rendera innehåll genom att slå upp SourceTag mot Source poster som beskrivs på bibliografiguide – fältklasserna hanterar rendering, och Source / Contributor klasserna håller den underliggande datan.


API Reference Sammanfattning

KlassBeskrivning
FieldHyperlinkHYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF fields; resolve content at a BookmarkName
FieldStyleRefSTYLEREF fält; löser till det närmaste stycket i en given stil
FieldSetSET fält; definierar ett bokmärkt textvärde för REF att lösa
FieldAsk / FieldFillInASK / FILLIN fält; uppmanar att ange ett värde vid uppdatering
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK fält; äldre OLE-länkat externt innehåll
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE fält; externt grafiskt innehåll
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT fält; externt dokument eller XML innehåll
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY fält; referensbyggstenposter
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY fält; rendera bibliografikälldata
FieldQuote / FieldShapeQUOTE / SHAPE fält; bokstavlig fälttext
DocumentBuilder.InsertHyperlinkKortkommando för hyperlänkinfogning på hög nivå
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkSkapande av bokmärken och navigering för referensmål

Se även

 Svenska