Bekerja dengan Tautan dan Referensi
Gambaran Umum
Kode bidang tautan dan referensi silang Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, dan lainnya – masing-masing diimplementasikan sebagai sebuah khusus Field subkelas dalam Aspose.Words FOSS for .NET. Semua kelas ini berada di dalam Aspose.Words.Fields namespace bersama setiap tipe bidang lainnya; halaman ini mengelompokkan yang secara khusus berhubungan dengan tautan, referensi silang, nilai yang diminta, dan sitasi, serta menjelaskan apa yang diungkapkan masing-masing.
Hyperlinks
FieldHyperlink mewakili bidang HYPERLINK: Address dan SubAddress menyimpan URL target atau lokasi dalam dokumen, ScreenTip mengatur tooltip saat mengarahkan kursor, OpenInNewWindow dan IsImageMap adalah flag tampilan, dan Target memberi nama pada bingkai peramban. Untuk kasus sederhana, DocumentBuilder.InsertHyperlink() menyisipkan bidang hyperlink secara langsung tanpa harus membuat objek Field secara manual.
Referensi Silang ke Penanda
FieldRef (bidang REF), FieldPageRef (PAGEREF), dan FieldNoteRef (NOTEREF) masing-masing mengarah ke konten pada penanda bernama melalui properti BookmarkName mereka, dengan InsertHyperlink dan InsertRelativePosition mengendalikan apakah referensi dapat diklik dan apakah ia melaporkan posisi relatif (“di atas” / “di bawah”). FieldRef menambahkan opsi penomoran paragraf (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) dan IncludeNoteOrComment. FieldStyleRef (STYLEREF) justru mengarah ke paragraf terdekat yang diformat dengan StyleName tertentu, dengan SearchFromBottom untuk mencari mundur dari posisi bidang. Penanda yang menjadi target bidang ini dibuat dengan DocumentBuilder.StartBookmark() dan EndBookmark(), dan dapat dinavigasi dengan MoveToBookmark(). FieldSet (SET) mendefinisikan nilai teks yang ditandai — BookmarkName dan BookmarkText — yang dapat diakses oleh bidang REF di tempat lain.
Bidang Nilai yang Diminta
FieldAsk (ASK) dan FieldFillIn (FILLIN) meminta nilai dari siapa pun yang memperbarui bidang: PromptText ditampilkan kepada pengguna, DefaultResponse menyediakan fallback, PromptOnceOnMailMerge membatasi permintaan berulang selama mail merge. FieldAsk selain itu menyimpan jawabannya di BookmarkName untuk referensi bidang lain. Lihat panduan bidang for IFieldUserPromptRespondent, callback yang menyediakan jawaban untuk bidang-bidang ini secara programatis alih-alih meminta secara interaktif.
Konten Eksternal dan Tertaut
FieldDde (DDE) dan FieldDdeAuto (DDEAUTO) menautkan ke konten di aplikasi lain melalui ProgId, SourceFullName, dan SourceItem, dengan InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode, dan InsertAsBitmap memilih representasi yang disisipkan, serta AutoUpdate / IsLinked mengontrol perilaku penyegaran. FieldLink (LINK) adalah setara OLE-link, menambahkan FormatUpdateType. FieldImport (IMPORT) dan FieldIncludePicture (INCLUDEPICTURE) memasukkan grafik eksternal melalui SourceFullName dan GraphicFilter. FieldInclude (INCLUDE) dan FieldIncludeText (INCLUDETEXT) memasukkan konten dokumen eksternal, dengan BookmarkName untuk menentukan rentang yang disertakan dan LockFields untuk mencegahnya disegarkan; FieldIncludeText juga mendukung sumber XML melalui Encoding, MimeType, NamespaceMappings, XPath, dan XslTransformation.
AutoText dan Referensi Glosarium
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST), dan FieldGlossary (GLOSSARY) semuanya merujuk ke entri blok bangunan bernama melalui EntryName; FieldAutoTextList menambahkan ListStyle dan ScreenTip untuk presentasi gaya daftar.
Bidang Sitasi dan Bibliografi
FieldCitation (CITATION) dan FieldBibliography (BIBLIOGRAPHY) merender konten yang bersumber dari data bibliografi dokumen. FieldCitation.SourceTag (dan alternatif AnotherSourceTag) mengidentifikasi sumber mana yang dikutip, dengan Prefix, Suffix, PageNumber, VolumeNumber, dan yang Suppress* bendera (SuppressAuthor, SuppressTitle, SuppressYear) yang mengontrol bagaimana sitasi diformat. FieldBibliography.SourceTag, FilterLanguageId, dan FormatLanguageId mengontrol sumber mana yang muncul dalam bibliografi yang dihasilkan dan dalam bahasa apa. Catatan sumber yang mendasari bidang-bidang ini dirender – Source, Contributor, Person – dibahas dalam panduan bibliografi.
Bidang Teks Kutipan dan Bentuk
FieldQuote (QUOTE) dan FieldShape (SHAPE) keduanya mengekspos properti Text yang memuat teks literal bidang – FieldQuote menyisipkannya langsung pada posisi bidang, sementara FieldShape mengaitkannya dengan kode bidang yang membawa teks pada bentuk gambar.
Tips dan Praktik Terbaik
- Lebih pilih
DocumentBuilder.InsertHyperlink()untuk penyisipan hyperlink yang sederhana; hanya turun ke pembuatanFieldHyperlinksecara langsung bila Anda memerlukan properti sepertiScreenTipatauIsImageMapyang tidak diungkapkan oleh pintasan pembuat. FieldRef,FieldPageRef,FieldNoteRef, danFieldSetsemuanya berkoordinasi melaluiBookmarkName– pastikan bookmark target ada (melaluiDocumentBuilder.StartBookmark()/EndBookmark()) sebelum bidang yang merujuknya diperbarui.- Setel
FieldOptions.UserPromptRespondent(lihat panduan bidang) sebelum memperbarui dokumen yang berisiFieldAskorFieldFillInbidang dalam pipeline yang tidak diawasi. FieldDdedanFieldDdeAutomemodelkan mekanisme penautan OLE Windows warisan – perlakukanAutoUpdatedanIsLinkedsebagai informasi ketika memproses dokumen di luar Windows, karena aplikasi eksternal yang biasanya mereka segarkan tidak tersedia.- Bidang sitasi dan bibliografi hanya dirender dengan benar setelah dasar dokumen
Sourcecatatan ada – lihat panduan bibliografi untuk membangunnya.
Masalah Umum
| Masalah | Penyebab | Perbaikan |
|---|---|---|
Bidang REF / PAGEREF / NOTEREF menunjukkan hasil error | BookmarkName yang ditargetkan tidak ada dalam dokumen | Buat penanda dengan DocumentBuilder.StartBookmark() / EndBookmark() sebelum memperbarui bidang |
Bidang ASK / FILLIN menghalangi pembaruan tanpa pengawasan | Tidak ada IFieldUserPromptRespondent yang ditetapkan | Tetapkan FieldOptions.UserPromptRespondent, atau atur DefaultResponse pada bidang |
Bidang CITATION atau BIBLIOGRAPHY menampilkan kosong | SourceTag tidak cocok dengan Source apa pun dalam data bibliografi dokumen | Tambahkan yang cocok Source – lihat the panduan bibliografi |
DDE / DDEAUTO / LINK field tidak menyegarkan | Ini merujuk ke sumber OLE eksternal yang tidak tersedia di lingkungan saat ini | Diharapkan di luar konteks Windows/OLE asli – perlakukan Result yang disimpan sebagai nilai terakhir yang diketahui |
FAQ
Apa perbedaan antara FieldRef dan FieldStyleRef?
FieldRef mengarah ke konten pada bookmark yang diberi nama (BookmarkName); FieldStyleRef justru mengarah ke paragraf terdekat yang diformat dengan StyleName tertentu, terlepas dari bookmark.
Bagaimana cara saya menyisipkan hyperlink sederhana tanpa membuat Field secara manual?
Panggil DocumentBuilder.InsertHyperlink().
Apakah kelas bidang tautan dan referensi ini berada di namespace terpisah dari bidang lainnya?
Tidak – FieldHyperlink, FieldRef, FieldCitation, dan sisanya kelas pada halaman ini adalah biasa Field subkelas dalam Aspose.Words.Fields ruang nama, ruang nama yang sama dibahas dalam the panduan bidang.
Bagaimana bidang sitasi terkait dengan model data bibliografi?
FieldCitation and FieldBibliography render konten dengan mencari SourceTag terhadap Source catatan yang dijelaskan pada panduan bibliografi – kelas field menangani rendering, dan Source / Contributor kelas menyimpan data yang mendasari.
API Reference Ringkasan
| Kelas | Deskripsi |
|---|---|
FieldHyperlink | HYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF fields; selesaikan konten pada sebuah BookmarkName |
FieldStyleRef | STYLEREF field; menghasilkan paragraf terdekat dalam gaya tertentu |
FieldSet | SET field; mendefinisikan nilai teks yang ditandai untuk REF yang akan diresolusikan |
FieldAsk / FieldFillIn | ASK / FILLIN fields; meminta nilai selama pembaruan |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK fields; konten eksternal OLE-tautan warisan |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE field; konten grafis eksternal |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT field; dokumen eksternal atau konten XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY fields; referensi entri blok bangunan |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY fields; menampilkan data sumber bibliografi |
FieldQuote / FieldShape | QUOTE / SHAPE fields; teks bidang literal |
DocumentBuilder.InsertHyperlink | Pintasan penyisipan hyperlink tingkat tinggi |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Pembuatan bookmark dan navigasi untuk target referensi |