Lucrul cu legături și referințe
Lucrul cu linkuri și referințe
Codurile de câmp pentru legături și referințe încrucișate în Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, și altele – sunt fiecare implementate ca o Field subclasă în Aspose.Words FOSS pentru .NET. Toate aceste clase se află în Aspose.Words.Fields spațiul de nume alături de fiecare alt tip de câmp; această pagină grupează pe cele care se ocupă în mod specific de legături, referințe încrucișate, valori solicitate și citări, și prezintă ce expune fiecare dintre ele.
Hyperlinks
FieldHyperlink reprezintă câmpul HYPERLINK: Address și SubAddress conțin URL-ul țintă sau locația din document, ScreenTip setează indiciul la trecerea mouse-ului, OpenInNewWindow și IsImageMap sunt steaguri de afișare, iar Target numește un cadru de browser. Pentru cazuri simple, DocumentBuilder.InsertHyperlink() inserează un câmp hyperlink direct, fără a construi manual obiectul Field.
Referințe încrucișate la semne de carte
FieldRef (câmpul REF), FieldPageRef (PAGEREF) și FieldNoteRef (NOTEREF) se rezolvă fiecare la conținutul unui semn de carte numit prin proprietatea lor BookmarkName, cu InsertHyperlink și InsertRelativePosition care controlează dacă referința este clicabilă și dacă raportează o poziție relativă („deasupra” / „sub”). FieldRef adaugă opțiuni de numerotare a paragrafelor (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) și IncludeNoteOrComment. FieldStyleRef (STYLEREF) în schimb se rezolvă la cel mai apropiat paragraf formatat cu un anumit StyleName, cu SearchFromBottom pentru a căuta înapoi de la poziția câmpului. Semnele de carte vizate de aceste câmpuri sunt create cu DocumentBuilder.StartBookmark() și EndBookmark(), și pot fi accesate cu MoveToBookmark(). FieldSet (SET) definește o valoare de text semn de carte – BookmarkName și BookmarkText – pe care un câmp REF din altă parte îl poate rezolva.
Câmpuri cu valori solicitate
FieldAsk (ASK) și FieldFillIn (FILLIN) solicită o valoare de la oricine actualizează câmpul: PromptText este afișat utilizatorului, DefaultResponse furnizează o soluție de rezervă, și PromptOnceOnMailMerge limitează solicitările repetate în timpul unei fuziuni de corespondență. FieldAsk în plus, stochează răspunsul său la BookmarkName pentru ca alte câmpuri să le facă referire. Vezi ghidul de câmpuri for IFieldUserPromptRespondent, apelul invers care furnizează răspunsuri acestor câmpuri programatic, în loc să solicite interactiv.
Conținut extern și legat
FieldDde (DDE) și FieldDdeAuto (DDEAUTO) leagă la conținut dintr-o altă aplicație prin ProgId, SourceFullName și SourceItem, cu InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode și InsertAsBitmap selectând reprezentarea inserată, și AutoUpdate / IsLinked controlând comportamentul de reîmprospătare. FieldLink (LINK) este echivalentul OLE-link, adăugând FormatUpdateType. FieldImport (IMPORT) și FieldIncludePicture (INCLUDEPICTURE) încarcă un grafic extern prin SourceFullName și GraphicFilter. FieldInclude (INCLUDE) și FieldIncludeText (INCLUDETEXT) încarcă conținut de document extern, cu BookmarkName pentru a delimita intervalul inclus și LockFields pentru a împiedica reîmprospătarea; FieldIncludeText susține, de asemenea, surse XML prin Encoding, MimeType, NamespaceMappings, XPath și XslTransformation.
AutoText și referințe la glosar
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) și FieldGlossary (GLOSSARY) fac toate referire la o intrare numită de tip building-block prin EntryName; FieldAutoTextList adaugă ListStyle și ScreenTip pentru prezentarea sa în stil listă.
Câmpuri de citare și bibliografie
FieldCitation (CITATION) și FieldBibliography (BIBLIOGRAPHY) redă conținutul preluat din datele bibliografice ale documentului. FieldCitation.SourceTag (și alternativa AnotherSourceTag) identifică sursa pe care o citează, cu Prefix, Suffix, PageNumber, VolumeNumber, și Suppress* indicatori (SuppressAuthor, SuppressTitle, SuppressYear) controlând modul în care este formatată citația. FieldBibliography.SourceTag, FilterLanguageId, și FormatLanguageId controlează care surse apar în bibliografia redată și în ce limbă. Înregistrările sursei de bază redau aceste câmpuri – Source, Contributor, Person – sunt acoperite în ghidul de bibliografie.
Câmpuri de citat și text de formă
FieldQuote (QUOTE) și FieldShape (SHAPE) expun ambele o proprietate Text care conține text literal al câmpului – FieldQuote îl inserează direct la poziția câmpului, în timp ce FieldShape îl asociază cu codul de câmp al formei de desen care poartă text.
Sfaturi și cele mai bune practici
- Preferă
DocumentBuilder.InsertHyperlink()pentru inserarea simplă a hyperlink-urilor; apelează la construirea directă a unuiFieldHyperlinkdoar când ai nevoie de proprietăți precumScreenTipsauIsImageMappe care scurtătura de construcție nu le expune. FieldRef,FieldPageRef,FieldNoteRefșiFieldSetse coordonează toate prinBookmarkName– asigură-te că semnul de carte țintă există (prinDocumentBuilder.StartBookmark()/EndBookmark()) înainte ca câmpul care îl referă să fie actualizat.- Set
FieldOptions.UserPromptRespondent(vezi ghidul de câmpuri) înainte de a actualiza un document care conțineFieldAskorFieldFillIncâmpuri într-un pipeline neasistat. FieldDdeșiFieldDdeAutomodelează un mecanism de legare OLE moștenit de Windows – trateazăAutoUpdateșiIsLinkedca informaționale atunci când procesezi documente în afara Windows, deoarece aplicația externă din care ar fi actualizat în mod normal nu este disponibilă.- Câmpurile de citare și bibliografie se redau corect doar după ce structura de bază a documentului.
Sourceînregistrările există – vezi ghidul de bibliografie pentru a le construi.
Probleme comune
| Problemă | Cauză | Remediere |
|---|---|---|
REF / PAGEREF / NOTEREF câmpul afișează un rezultat de eroare | BookmarkName pe care îl vizează nu există în document | Creează semnul de carte cu DocumentBuilder.StartBookmark() / EndBookmark() înainte de a actualiza câmpul |
Câmpul ASK / FILLIN blochează o actualizare nesupravegheată | Niciun IFieldUserPromptRespondent nu este atribuit | Atribuie FieldOptions.UserPromptRespondent, sau setează DefaultResponse pe câmp |
Câmpul CITATION sau BIBLIOGRAPHY afișează gol | SourceTag nu se potrivește cu niciun Source din datele bibliografice ale documentului | Adaugă potrivirea Source – vezi ghid de bibliografie |
DDE / DDEAUTO / LINK câmpul nu se actualizează | Aceste fac referire la o sursă OLE externă care nu este disponibilă în mediul curent | Așteptat în afara contextului original Windows/OLE – tratați Result stocat ca valoarea ultimă cunoscută |
FAQ
Care este diferența dintre FieldRef și FieldStyleRef?
FieldRef rezolvă la conținutul de la un semn de carte numit (BookmarkName); FieldStyleRef în schimb rezolvă la cel mai apropiat paragraf formatat cu un anumit StyleName, independent de semnele de carte.
Cum pot insera o legătură simplă fără să construiesc manual un Field?
Apelă DocumentBuilder.InsertHyperlink().
Aceste clase de câmpuri de legătură și referință se află într-un spațiu de nume separat față de alte câmpuri?
Nu – FieldHyperlink, FieldRef, FieldCitation, iar restul claselor de pe această pagină sunt obișnuite Field subclase în Aspose.Words.Fields spațiu de nume, același spațiu de nume acoperit în ghidul câmpurilor.
Cum se raportează câmpurile de citare la modelul de date al bibliografiei?
FieldCitation and FieldBibliography randează conținutul prin căutare SourceTag împotriva Source înregistrările descrise în ghidul de bibliografie – clasele de câmp gestionează randarea și Source / Contributor clasele dețin datele subiacente.
Rezumat API Reference
| Clasă | Descriere: |
|---|---|
FieldHyperlink | HYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF câmpuri; rezolvă conținutul la un BookmarkName |
FieldStyleRef | STYLEREF câmp; se rezolvă la cel mai apropiat paragraf într-un stil dat |
FieldSet | SET câmp; definește o valoare de text marcată pentru REF de rezolvat |
FieldAsk / FieldFillIn | ASK / FILLIN câmpuri; solicită o valoare în timpul actualizării |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK câmpuri; conținut extern legat prin OLE legacy |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE câmpuri; conținut grafic extern |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT câmpuri; document extern sau XML conținut |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY câmpuri; intrări de blocuri de construcție de referință |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY câmpuri; redă datele sursă ale bibliografiei |
FieldQuote / FieldShape | QUOTE / SHAPE câmpuri; text literal al câmpului |
DocumentBuilder.InsertHyperlink | Scurtătură de inserare a hyperlink-ului la nivel înalt |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Crearea de marcaje și navigarea către țintele de referință |