แทรกฟิลด์

มีหลายวิธีในการแทรกฟิลด์ลงในเอกสาร:

ในบทความนี้เราจะดูที่แต่ละวิธีในรายละเอียดมากขึ้นและวิเคราะห์วิธีการแทรกเขตข้อมูลบางอย่างโดยใช้ตัวเลือกเหล่านี้.

การใส่ฟิลด์ลงในเอกสารโดยใช้DocumentBuilder

ในAspose.WordsวิธีInsertFieldจะใช้ในการแทรกฟิลด์ใหม่ลงในเอกสาร พารามิเตอร์แรกยอมรับรหัสฟิลด์เต็มของฟิลด์ที่จะแทรก พารามิเตอร์ที่สองเป็นตัวเลือกและอนุญาตให้ฟิลด์ผลลัพธ์ของฟิลด์ที่จะตั้งค่าด้วยตนเอง อัพเดตโดยอัตโนมัติ คุณสามารถส่งผ่านโมฆะหรือว่างไปยังพารามิเตอร์นี้เพื่อแทรกฟิลด์ที่มีค่าฟิลด์ว่าง หากคุณไม่แน่ใจเกี่ยวกับไวยากรณ์รหัสฟิลด์เฉพาะ,สร้างฟิลด์ในMicrosoft Wordก่อนและสลับเพื่อดูรหัสฟิลด์.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการแทรกฟิลด์ผสานลงในเอกสารโดยใช้DocumentBuilder:

เทคนิคเดียวกันจะใช้เพื่อแทรกฟิลด์ที่ซ้อนกันภายในฟิลด์อื่น.

ตัวอย่างรหัสต่อไปนี้สาธิตวิธีการแทรกฟิลด์ที่ซ้อนกันภายในฟิลด์อื่นโดยใช้DocumentBuilder:

ระบุโลแคลที่ระดับฟิลด์

ตัวระบุภาษาเป็นตัวย่อตัวเลขสากลมาตรฐานสำหรับภาษาในประเทศหรือภูมิภาคทางภูมิศ ด้วยAspose.Wordsคุณสามารถระบุโลแคลที่ระดับฟิลด์โดยใช้คุณสมบัติLocaleIdซึ่งได้รับหรือตั้งค่าโลแคลของฟิลด์ID.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีใช้ตัวเลือกนี้:

แทรกเขตข้อมูลที่ไม่ได้พิมพ์/ว่างเปล่า

หากคุณต้องการแทรกฟิลด์ที่ไม่ได้พิมพ์/ว่างเปล่า({})เช่นเดียวกับMicrosoft Wordอนุญาต,คุณสามารถใช้วิธีการInsertFieldกับFieldType.FieldNoneพารามิเตอร์. เมื่อต้องการแทรกฟิลด์ลงในเอกสารคำคุณสามารถกดปุ่ม"ควบคุมการ+F9".

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการแทรกฟิลด์ว่างลงในเอกสาร:

แทรกฟิลด์COMPARE

ฟิลด์COMPAREเปรียบเทียบค่าสองค่าและส่งคืนค่าตัวเลข 1 ถ้าการเปรียบเทียบเป็นจริงหรือ 0 ถ้าการเปรียบเทียบเป็นเท็จ.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีเพิ่มฟิลด์COMPAREโดยใช้DocumentBuilder:

แทรกฟิลด์IF

ฟิลด์IFสามารถใช้เพื่อประเมินอาร์กิวเมนต์ตามเงื่อนไข.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีเพิ่มฟิลด์IFโดยใช้DocumentBuilder:

การใส่ฟิลด์ลงในเอกสารโดยใช้FieldBuilder

ทางเลือกในการแทรกฟิลด์ในAspose.WordsคือFieldBuilderคลาส จะมีอินเตอร์เฟซที่คล่องแคล่วในการระบุสวิทช์ฟิลด์และค่าอาร์กิวเมนต์เป็นข้อความโหนดห.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการแทรกฟิลด์ลงในเอกสารโดยใช้FieldBuilder:

การใส่ฟิลด์โดยใช้DOM

นอกจากนี้คุณยังสามารถแทรกประเภทต่างๆของเขตข้อมูลโดยใช้ Aspose.Wordsรูปแบบวัตถุเอกสาร(DOM). ในส่วนนี้เราจะดูตัวอย่างบางส่วน.

การแทรกฟิลด์ผสานลงในเอกสารโดยใช้DOM

MERGEFIELD field in Word document can be represented by the FieldMergeField class. You can use FieldMergeField class to perform the following operations:

  • ระบุชื่อของฟิลด์ผสาน
  • ระบุการจัดรูปแบบของฟิลด์ผสาน
  • ระบุข้อความที่อยู่ระหว่างตัวคั่นฟิลด์และฟิลด์สิ้นสุดของฟิลด์ผสาน
  • ระบุข้อความที่จะแทรกหลังจากฟิลด์ผสานถ้าฟิลด์ไม่ว่างเปล่า
  • ระบุข้อความที่จะแทรกก่อนฟิลด์ผสานถ้าฟิลด์ไม่ว่าง

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มฟิลด์MERGEโดยใช้DOMไปยังย่อหน้าในเอกสาร:

การแทรกฟิลด์Mail MergeADDRESSBLOCKลงในเอกสารโดยใช้DOM

ฟิลด์ADDRESSBLOCKถูกใช้เพื่อแทรกบล็อกที่อยู่Mail Mergeในเอกสารคำ ADDRESSBLOCKฟิลด์ในเอกสารคำสามารถแสดงโดยFieldAddressBlockชั้น คุณสามารถใช้FieldAddressBlockคลาสในการดำเนินการดังต่อไปนี้:

  • ระบุว่าจะใส่ชื่อของประเทศ/ภูมิภาคในฟิลด์หรือไม่
  • ระบุว่าจะจัดรูปแบบที่อยู่ตามประเทศ/ภูมิภาคของผู้รับตามที่กำหนดโดยPOST*CODE(สหภาพไปรษณีย์สากล 2006)
  • ระบุชื่อประเทศ/ภูมิภาคที่ยกเว้น
  • ระบุชื่อและรูปแบบที่อยู่
  • ระบุภาษาIDที่ใช้ในการจัดรูปแบบที่อยู่

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มฟิลด์Mail MergeADDRESSBLOCKโดยใช้DOMไปยังย่อหน้าในเอกสาร:

การแทรกฟิลด์ADVANCEลงในเอกสารโดยไม่ใช้DocumentBuilder

ฟิลด์ADVANCEใช้เพื่อชดเชยข้อความที่ตามมาภายในบรรทัดไปทางซ้ายขวาขึ้นหรือลง ADVANCEฟิลด์ในเอกสารคำสามารถแสดงโดยFieldAdvanceชั้น คุณสามารถใช้ชั้นเรียนFieldAdvanceเพื่อดำเนินการดังต่อไปนี้:

  • ระบุจำนวนจุดที่ควรย้ายข้อความตามฟิลด์ในแนวตั้งจากขอบด้านบนของหน้า
  • ระบุจำนวนจุดที่ควรย้ายข้อความตามฟิลด์ในแนวนอนจากขอบด้านซ้ายของคอลัมน์เฟรมหรื
  • ระบุจำนวนจุดที่ข้อความตามฟิลด์ควรย้ายไปทางซ้ายขวาขึ้นหรือลง

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มฟิลด์ADVANCEโดยใช้DOMไปยังย่อหน้าในเอกสาร:

การแทรกฟิลด์ASKลงในเอกสารโดยไม่ใช้DocumentBuilder

ฟิลด์ASKถูกใช้เพื่อแจ้งให้ผู้ใช้สามารถกำหนดข้อความไปยังที่คั่นหน้าในเอกสารคำ ASKฟิลด์ในเอกสารคำสามารถแสดงโดยFieldAskชั้น คุณสามารถใช้ชั้นเรียนFieldAskเพื่อดำเนินการดังต่อไปนี้:

  • ระบุชื่อของบุ๊กมาร์ก
  • ระบุการตอบสนองของผู้ใช้ดีฟอลต์(ค่าเริ่มต้นที่มีอยู่ในหน้าต่างพร้อมท์)
  • ระบุว่าควรได้รับคำตอบของผู้ใช้หนึ่งครั้งต่อการดำเนินการMail Merge
  • ระบุข้อความพร้อมท์(ชื่อของหน้าต่างพร้อมท์)

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มฟิลด์ASKโดยใช้DOMไปยังย่อหน้าในเอกสาร:

การแทรกฟิลด์AUTHORลงในเอกสารโดยไม่ใช้DocumentBuilder

ฟิลด์AUTHORใช้เพื่อระบุชื่อของผู้เขียนของเอกสารจากคุณสมบัติDocument AUTHORฟิลด์ในเอกสารคำสามารถแสดงโดยFieldAuthorชั้น คุณสามารถใช้ชั้นเรียนFieldAuthorเพื่อดำเนินการดังต่อไปนี้:

  • ระบุชื่อผู้เขียนเอกสาร

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มฟิลด์AUTHORโดยใช้DOMไปยังย่อหน้าในเอกสาร:

การแทรกฟิลด์INCLUDETEXTลงในเอกสารโดยไม่ใช้DocumentBuilder

ฟิลด์INCLUDETEXTแทรกข้อความและกราฟิกที่มีอยู่ในเอกสารที่มีชื่อในรหัสฟิลด์ คุณสามารถแทรกเอกสารทั้งหมดหรือบางส่วนของเอกสารที่อ้างถึงโดยบุ๊กมาร์ก ฟิลด์นี้ในเอกสารคำแสดงด้วยINCLUDETEXT คุณสามารถใช้ชั้นเรียนFieldIncludeTextเพื่อดำเนินการดังต่อไปนี้:

  • ระบุชื่อของบุ๊กมาร์กของเอกสารที่รวมอยู่
  • ระบุตำแหน่งของเอกสาร

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มฟิลด์INCLUDETEXTโดยใช้DOMไปยังย่อหน้าในเอกสาร:

การแทรกฟิลด์TOAลงในเอกสารโดยไม่ใช้DocumentBuilder

ฟิลด์TOA(Table of Authorities)สร้างและแทรกตารางของเจ้าหน้าที่ ฟิลด์TOAรวบรวมรายการที่ทำเครื่องหมายด้วยฟิลด์TA(Table of Authorities Entry) Microsoftคำสำนักงานแทรกฟิลด์TOAเมื่อคุณคลิกInsert Table of Authoritiesในกลุ่มTable of Authoritiesบนแท็บReferences เมื่อคุณดูฟิลด์TOAในเอกสารของคุณไวยากรณ์มีลักษณะเช่นนี้:

{ TOA [Switches ] }

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มฟิลด์TOAโดยใช้DOMไปยังย่อหน้าในเอกสาร.