การทำงานกับลิงก์และการอ้างอิง

การทำงานกับลิงก์และการอ้างอิง

ภาพรวม

โค้ดฟิลด์ลิงก์และการอ้างอิงข้ามของ 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 (ดูที่ คู่มือฟิลด์) ก่อนอัปเดตเอกสารที่มี FieldAsk or FieldFillIn ฟิลด์ใน 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

คลาสคำอธิบาย
FieldHyperlinkHYPERLINK ฟิลด์; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF ฟิลด์; แก้ไขเนื้อหาที่ BookmarkName
FieldStyleRefSTYLEREF ฟิลด์; แก้ไขเป็นย่อหน้าที่ใกล้ที่สุดในสไตล์ที่กำหนด
FieldSetSET ฟิลด์; กำหนดค่าข้อความที่ทำเครื่องหมายบุ๊กมาร์กสำหรับ REF เพื่อแก้ไข
FieldAsk / FieldFillInฟิลด์ ASK / FILLIN; แสดงพรอมต์ให้ป้อนค่าในระหว่างการอัปเดต
FieldDde / FieldDdeAuto / FieldLinkฟิลด์ DDE / DDEAUTO / LINK; เนื้อหาภายนอกที่เชื่อมโยงด้วย OLE แบบดั้งเดิม
FieldImport / FieldIncludePictureฟิลด์ IMPORT / INCLUDEPICTURE; เนื้อหากราฟิกภายนอก
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT ฟิลด์; เอกสารภายนอกหรือเนื้อหา XML
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY ฟิลด์; อ้างอิงรายการบล็อกการสร้าง
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY ฟิลด์; แสดงผลข้อมูลแหล่งบรรณานุกรม
FieldQuote / FieldShapeQUOTE / SHAPE ฟิลด์; ข้อความฟิลด์ตามตัวอักษร
DocumentBuilder.InsertHyperlinkทางลัดการแทรกลิงก์ระดับสูง
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkการสร้างและการนำทาง Bookmark สำหรับเป้าหมายอ้างอิง

ดูเพิ่มเติม

 ภาษาไทย