Bekerja dengan Tautan dan Referensi

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 pembuatan FieldHyperlink secara langsung bila Anda memerlukan properti seperti ScreenTip atau IsImageMap yang tidak diungkapkan oleh pintasan pembuat.
  • FieldRef, FieldPageRef, FieldNoteRef, dan FieldSet semuanya berkoordinasi melalui BookmarkName – pastikan bookmark target ada (melalui DocumentBuilder.StartBookmark() / EndBookmark()) sebelum bidang yang merujuknya diperbarui.
  • Setel FieldOptions.UserPromptRespondent (lihat panduan bidang) sebelum memperbarui dokumen yang berisi FieldAsk or FieldFillIn bidang dalam pipeline yang tidak diawasi.
  • FieldDde dan FieldDdeAuto memodelkan mekanisme penautan OLE Windows warisan – perlakukan AutoUpdate dan IsLinked sebagai 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 Source catatan ada – lihat panduan bibliografi untuk membangunnya.

Masalah Umum

MasalahPenyebabPerbaikan
Bidang REF / PAGEREF / NOTEREF menunjukkan hasil errorBookmarkName yang ditargetkan tidak ada dalam dokumenBuat penanda dengan DocumentBuilder.StartBookmark() / EndBookmark() sebelum memperbarui bidang
Bidang ASK / FILLIN menghalangi pembaruan tanpa pengawasanTidak ada IFieldUserPromptRespondent yang ditetapkanTetapkan FieldOptions.UserPromptRespondent, atau atur DefaultResponse pada bidang
Bidang CITATION atau BIBLIOGRAPHY menampilkan kosongSourceTag tidak cocok dengan Source apa pun dalam data bibliografi dokumenTambahkan yang cocok Source – lihat the panduan bibliografi
DDE / DDEAUTO / LINK field tidak menyegarkanIni merujuk ke sumber OLE eksternal yang tidak tersedia di lingkungan saat iniDiharapkan 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

KelasDeskripsi
FieldHyperlinkHYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF fields; selesaikan konten pada sebuah BookmarkName
FieldStyleRefSTYLEREF field; menghasilkan paragraf terdekat dalam gaya tertentu
FieldSetSET field; mendefinisikan nilai teks yang ditandai untuk REF yang akan diresolusikan
FieldAsk / FieldFillInASK / FILLIN fields; meminta nilai selama pembaruan
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK fields; konten eksternal OLE-tautan warisan
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE field; konten grafis eksternal
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT field; dokumen eksternal atau konten XML
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY fields; referensi entri blok bangunan
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY fields; menampilkan data sumber bibliografi
FieldQuote / FieldShapeQUOTE / SHAPE fields; teks bidang literal
DocumentBuilder.InsertHyperlinkPintasan penyisipan hyperlink tingkat tinggi
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkPembuatan bookmark dan navigasi untuk target referensi

Lihat Juga

 Bahasa Indonesia