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 enFieldHyperlinkdirekt endast när du behöver egenskaper såsomScreenTipellerIsImageMapsom byggarens genväg inte exponerar. FieldRef,FieldPageRef,FieldNoteRefochFieldSetkoordinerar alla viaBookmarkName– se till att målbokmärket finns (viaDocumentBuilder.StartBookmark()/EndBookmark()) innan fältet som refererar till det uppdateras.- Sätt
FieldOptions.UserPromptRespondent(se fältguide) innan du uppdaterar ett dokument som innehållerFieldAskorFieldFillInfält i en oövervakad pipeline. FieldDdeochFieldDdeAutomodellerar en äldre Windows OLE-länkningsmekanism – behandlaAutoUpdateochIsLinkedsom 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
Sourceposter finns – se bibliografiguide för att bygga dem.
Vanliga problem
| Problem | Orsak | Åtgärd |
|---|---|---|
REF / PAGEREF / NOTEREF fältet visar ett felresultat | Det BookmarkName som den riktar mot finns inte i dokumentet | Skapa bokmärket med DocumentBuilder.StartBookmark() / EndBookmark() innan du uppdaterar fältet |
ASK / FILLIN fältet blockerar en obevakad uppdatering | Ingen IFieldUserPromptRespondent har tilldelats | Tilldela FieldOptions.UserPromptRespondent, eller ange DefaultResponse på fältet |
CITATION eller BIBLIOGRAPHY fältet visas tomt | SourceTag matchar inte någon Source i dokumentets bibliografidata | Lägg till den matchande Source – se bibliografiguide |
DDE / DDEAUTO / LINK fältet uppdateras inte | Dessa refererar till en extern OLE-källa som inte är tillgänglig i den aktuella miljön | Fö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
| Klass | Beskrivning |
|---|---|
FieldHyperlink | HYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF fields; resolve content at a BookmarkName |
FieldStyleRef | STYLEREF fält; löser till det närmaste stycket i en given stil |
FieldSet | SET fält; definierar ett bokmärkt textvärde för REF att lösa |
FieldAsk / FieldFillIn | ASK / FILLIN fält; uppmanar att ange ett värde vid uppdatering |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK fält; äldre OLE-länkat externt innehåll |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE fält; externt grafiskt innehåll |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT fält; externt dokument eller XML innehåll |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY fält; referensbyggstenposter |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY fält; rendera bibliografikälldata |
FieldQuote / FieldShape | QUOTE / SHAPE fält; bokstavlig fälttext |
DocumentBuilder.InsertHyperlink | Kortkommando för hyperlänkinfogning på hög nivå |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Skapande av bokmärken och navigering för referensmål |