การทำงานกับลิงก์และการอ้างอิง
ภาพรวม
โค้ดฟิลด์ลิงก์และการอ้างอิงข้ามของ Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, และอื่น ๆ – ถูกทำให้เป็นแต่ละอย่างโดยใช้คลาสเฉพาะ Field ซับคลาสใน Aspose.Words FOSS สำหรับ .NET. คลาสทั้งหมดเหล่านี้อยู่ใน Aspose.Words.Fields เนมสเปซพร้อมกับประเภทฟิลด์อื่น ๆ ทุกประเภท; หน้านี้จัดกลุ่มของที่เกี่ยวข้องโดยเฉพาะกับลิงก์, การอ้างอิงข้าม, ค่าที่ได้รับการกระตุ้น, และการอ้างอิง, และอธิบายว่าทุกคลาสเปิดเผยอะไรบ้าง.
Hyperlinks
FieldHyperlink แทนฟิลด์ HYPERLINK: Address และ SubAddress เก็บ URL ปลายทางหรือที่ตั้งภายในเอกสาร, ScreenTip ตั้งค่าเครื่องมือแสดงเมื่อโฮเวอร์, OpenInNewWindow และ IsImageMap เป็นแฟล็กการแสดงผล, และ Target ระบุชื่อเฟรมของเบราว์เซอร์. ในกรณีง่าย, DocumentBuilder.InsertHyperlink() แทรกฟิลด์ไฮเปอร์ลิงก์โดยตรงโดยไม่ต้องสร้างวัตถุ Field ด้วยตนเอง.
การอ้างอิงข้ามไปยังบุ๊คมาร์ค
FieldRef (ฟิลด์ REF), FieldPageRef (PAGEREF), และ FieldNoteRef (NOTEREF) แต่ละตัวจะอ้างอิงถึงเนื้อหาที่บุ๊คมาร์คที่ตั้งชื่อผ่านคุณสมบัติ BookmarkName ของมัน, โดย InsertHyperlink และ InsertRelativePosition ควบคุมว่าการอ้างอิงนั้นคลิกได้หรือไม่และว่ามันรายงานตำแหน่งสัมพัทธ์ (“เหนือ” / “ใต้”) อย่างไร. FieldRef เพิ่มตัวเลือกการจัดหมายเลขย่อหน้า (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) และ IncludeNoteOrComment. FieldStyleRef (STYLEREF) แทนที่จะอ้างอิงถึงย่อหน้าที่ใกล้ที่สุดที่มีรูปแบบตาม StyleName ที่กำหนด, โดยใช้ SearchFromBottom เพื่อค้นย้อนกลับจากตำแหน่งของฟิลด์. บุ๊คมาร์คที่ฟิลด์เหล่านี้เป้าหมายสร้างด้วย DocumentBuilder.StartBookmark() และ EndBookmark(), และสามารถนำทางไปยังได้ด้วย MoveToBookmark(). FieldSet (SET) กำหนดค่าข้อความที่ถูกบุ๊คมาร์ค – BookmarkName และ BookmarkText – ที่ฟิลด์ REF อื่น ๆ สามารถอ้างอิงได้.
ฟิลด์ค่าที่ถูกกระตุ้น
FieldAsk (ASK) และ FieldFillIn (FILLIN) ขอค่าจากผู้ที่ทำการอัปเดตฟิลด์: PromptText จะแสดงให้ผู้ใช้เห็น, DefaultResponse จัดหา fallback, และ PromptOnceOnMailMerge จำกัดการถามซ้ำระหว่างการรวมเมล. FieldAsk นอกจากนี้ยังบันทึกคำตอบของมันที่ BookmarkName เพื่อให้ฟิลด์อื่นอ้างอิงได้. ดู คู่มือฟิลด์ for IFieldUserPromptRespondent, คอลแบ็กที่จัดหาคำตอบให้ฟิลด์เหล่านี้โดยโปรแกรมแทนการถามแบบโต้ตอบ.
เนื้อหาภายนอกและเชื่อมโยง
FieldDde (DDE) และ FieldDdeAuto (DDEAUTO) เชื่อมโยงไปยังเนื้อหาในแอปพลิเคชันอื่นผ่าน ProgId, SourceFullName และ SourceItem, โดย InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode และ InsertAsBitmap เลือกการแสดงผลที่แทรก, และ AutoUpdate / IsLinked ควบคุมพฤติกรรมการรีเฟรช. FieldLink (LINK) เป็นเทียบเท่า OLE-link, เพิ่ม FormatUpdateType. FieldImport (IMPORT) และ FieldIncludePicture (INCLUDEPICTURE) ดึงกราฟิกภายนอกผ่าน SourceFullName และ GraphicFilter. FieldInclude (INCLUDE) และ FieldIncludeText (INCLUDETEXT) ดึงเนื้อหาเอกสารภายนอก, โดยใช้ BookmarkName เพื่อกำหนดช่วงที่รวมและ LockFields เพื่อป้องกันไม่ให้รีเฟรช; FieldIncludeText ยังสนับสนุนแหล่ง XML ผ่าน Encoding, MimeType, NamespaceMappings, XPath และ XslTransformation.
AutoText และการอ้างอิงอภิธานศัพท์
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) และ FieldGlossary (GLOSSARY) ทั้งหมดอ้างอิงรายการบล็อกอาคารที่ตั้งชื่อผ่าน EntryName; FieldAutoTextList เพิ่ม ListStyle และ ScreenTip สำหรับการนำเสนอแบบรายการ.
ฟิลด์การอ้างอิงและบรรณานุกรม
FieldCitation (CITATION) และ FieldBibliography (BIBLIOGRAPHY) แสดงเนื้อหาที่ได้มาจากข้อมูลบรรณานุกรมของเอกสาร. FieldCitation.SourceTag (และทางเลือก AnotherSourceTag) ระบุว่าแหล่งที่อ้างถึงคือแหล่งใด, ด้วย Prefix, Suffix, PageNumber, VolumeNumber, และ Suppress* แฟล็ก (SuppressAuthor, SuppressTitle, SuppressYear) ควบคุมวิธีการจัดรูปแบบการอ้างอิง. FieldBibliography.SourceTag, FilterLanguageId, และ FormatLanguageId ควบคุมว่าแหล่งข้อมูลใดปรากฏในบรรณานุกรมที่แสดงผลและใช้ภาษาอะไร บันทึกแหล่งข้อมูลพื้นฐานจะบันทึกฟิลด์เหล่านี้เพื่อแสดงผล – Source, Contributor, Person – จะได้รับการครอบคลุมใน คู่มือบรรณานุกรม.
ฟิลด์ข้อความอ้างอิงและรูปร่าง
FieldQuote (QUOTE) และ FieldShape (SHAPE) ทั้งคู่เปิดเผยคุณสมบัติ Text ที่ถือข้อความฟิลด์ตามตัวอักษร – FieldQuote แทรกมันโดยตรงที่ตำแหน่งของฟิลด์, ในขณะที่ FieldShape เชื่อมโยงมันกับรหัสฟิลด์ที่บรรจุข้อความของรูปวาด.
เคล็ดลับและแนวทางปฏิบัติที่ดีที่สุด
- เลือกใช้
DocumentBuilder.InsertHyperlink()สำหรับการแทรกลิงก์อย่างตรงไปตรงมา; ลดระดับลงไปสร้างFieldHyperlinkโดยตรงเฉพาะเมื่อคุณต้องการคุณสมบัติเช่นScreenTipหรือIsImageMapที่ทางลัดของตัวสร้างไม่เปิดเผย. FieldRef,FieldPageRef,FieldNoteRefและFieldSetทั้งหมดประสานงานผ่านBookmarkName– ตรวจสอบให้แน่ใจว่าที่คั่นหน้าเป้าหมายมีอยู่ (ผ่านDocumentBuilder.StartBookmark()/EndBookmark()) ก่อนที่ฟิลด์ที่อ้างอิงมันจะถูกอัปเดต.- ตั้งค่า
FieldOptions.UserPromptRespondent(ดูที่ คู่มือฟิลด์) ก่อนอัปเดตเอกสารที่มีFieldAskorFieldFillInฟิลด์ใน pipeline ที่ทำงานโดยไม่มีการดูแล. FieldDdeและFieldDdeAutoจำลองกลไกการเชื่อมโยง OLE ของ Windows รุ่นเก่า – ปฏิบัติกับAutoUpdateและIsLinkedเป็นข้อมูลเมื่อประมวลผลเอกสารนอก Windows, เนื่องจากแอปพลิเคชันภายนอกที่ปกติจะรีเฟรชจากนั้นไม่พร้อมใช้งาน.- ฟิลด์การอ้างอิงและบรรณานุกรมจะแสดงผลอย่างถูกต้องก็ต่อเมื่อพื้นฐานของเอกสาร
Sourceมีบันทึกอยู่ – ดู คู่มือบรรณานุกรม สำหรับการสร้างสิ่งเหล่านั้น.
ปัญหาทั่วไป
| ปัญหา | สาเหตุ | แก้ไข |
|---|---|---|
ฟิลด์ REF / PAGEREF / NOTEREF แสดงผลลัพธ์ข้อผิดพลาด | BookmarkName ที่กำหนดเป้าหมายไม่มีอยู่ในเอกสาร | สร้างบุ๊กมาร์กด้วย DocumentBuilder.StartBookmark() / EndBookmark() ก่อนอัปเดตฟิลด์ |
ฟิลด์ ASK / FILLIN บล็อกการอัปเดตโดยอัตโนมัติ | ไม่มีการกำหนด IFieldUserPromptRespondent | กำหนด FieldOptions.UserPromptRespondent หรือกำหนด DefaultResponse บนฟิลด์ |
ฟิลด์ CITATION หรือ BIBLIOGRAPHY แสดงผลเป็นค่าว่าง | SourceTag ไม่ตรงกับ Source ใดในข้อมูลบรรณานุกรมของเอกสาร | เพิ่มรายการที่ตรงกัน Source – ดูที่ คู่มือบรรณานุกรม |
DDE / DDEAUTO / LINK ฟิลด์ไม่รีเฟรช | สิ่งเหล่านี้อ้างอิงแหล่งข้อมูล OLE ภายนอกที่ไม่พร้อมใช้งานในสภาพแวดล้อมปัจจุบัน | คาดว่าจะอยู่ภายนอกบริบท Windows/OLE ดั้งเดิม – ให้พิจารณา Result ที่เก็บไว้เป็นค่าที่ทราบล่าสุด |
FAQ
สิ่งที่แตกต่างระหว่าง FieldRef และ FieldStyleRef คืออะไร?
FieldRef จะอ้างอิงถึงเนื้อหาในที่คั่นชื่อ (BookmarkName); ส่วน FieldStyleRef จะอ้างอิงถึงย่อหน้าที่ใกล้ที่สุดที่จัดรูปแบบด้วย StyleName ที่กำหนด, ไม่ขึ้นกับที่คั่น.
ฉันจะใส่ลิงก์ง่าย ๆ อย่างไรโดยไม่ต้องสร้าง Field ด้วยตนเอง?
เรียก DocumentBuilder.InsertHyperlink().
คลาสฟิลด์ลิงก์และอ้างอิงเหล่านี้อยู่ในชื่อพื้นที่แยกจากฟิลด์อื่น ๆ หรือไม่?
ไม่มี – FieldHyperlink, FieldRef, FieldCitation, และคลาสที่เหลือบนหน้านี้เป็นปกติ Field คลาสย่อยใน the Aspose.Words.Fields namespace, ชุดชื่อเดียวกันที่ครอบคลุมใน คู่มือฟิลด์.
ฟิลด์การอ้างอิงมีความสัมพันธ์อย่างไรกับโมเดลข้อมูลบรรณานุกรม?
FieldCitation and FieldBibliography เรนเดอร์เนื้อหาโดยการค้นหา SourceTag ต่อ Source บันทึกที่อธิบายบน คู่มือบรรณานุกรม – คลาสฟิลด์จัดการการเรนเดอร์, และ Source / Contributor คลาสเก็บข้อมูลพื้นฐาน.
สรุป API Reference
| คลาส | คำอธิบาย |
|---|---|
FieldHyperlink | HYPERLINK ฟิลด์; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF ฟิลด์; แก้ไขเนื้อหาที่ BookmarkName |
FieldStyleRef | STYLEREF ฟิลด์; แก้ไขเป็นย่อหน้าที่ใกล้ที่สุดในสไตล์ที่กำหนด |
FieldSet | SET ฟิลด์; กำหนดค่าข้อความที่ทำเครื่องหมายบุ๊กมาร์กสำหรับ REF เพื่อแก้ไข |
FieldAsk / FieldFillIn | ฟิลด์ ASK / FILLIN; แสดงพรอมต์ให้ป้อนค่าในระหว่างการอัปเดต |
FieldDde / FieldDdeAuto / FieldLink | ฟิลด์ DDE / DDEAUTO / LINK; เนื้อหาภายนอกที่เชื่อมโยงด้วย OLE แบบดั้งเดิม |
FieldImport / FieldIncludePicture | ฟิลด์ IMPORT / INCLUDEPICTURE; เนื้อหากราฟิกภายนอก |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT ฟิลด์; เอกสารภายนอกหรือเนื้อหา XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY ฟิลด์; อ้างอิงรายการบล็อกการสร้าง |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY ฟิลด์; แสดงผลข้อมูลแหล่งบรรณานุกรม |
FieldQuote / FieldShape | QUOTE / SHAPE ฟิลด์; ข้อความฟิลด์ตามตัวอักษร |
DocumentBuilder.InsertHyperlink | ทางลัดการแทรกลิงก์ระดับสูง |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | การสร้างและการนำทาง Bookmark สำหรับเป้าหมายอ้างอิง |