ส่วนหัวคือระยะขอบบนของแต่ละหน้า และส่วนท้ายคือระยะขอบล่างของแต่ละหน้า ส่วนหัวและส่วนท้ายมีประโยชน์ในการรวมข้อมูลที่คุณต้องการแสดงในทุกหน้าของเอกสาร เช่น ชื่อ วันที่ ชื่อเรื่องของเอกสาร หมายเลขหน้า หรือข้อความปฏิเสธความรับผิดชอบในเอกสาร เมื่อใช้ MS Word โปรแกรมจะเพิ่มความสามารถในการเพิ่มส่วนหัวและส่วนท้ายตามเค้าโครงที่กำหนดไว้ล่วงหน้า หรือให้คุณเพิ่มส่วนหัวและส่วนท้ายแบบกำหนดเองได้ ส่วนหัวในตัวส่วนใหญ่มีข้อความตัวแทน และคุณสามารถเก็บข้อความตัวแทนไว้หรือแทนที่ด้วยฟีดข้อมูลของคุณเอง นอกจากนี้ เมื่ออัปเดตข้อมูลในส่วนหัวหรือส่วนท้าย เนื้อหาภายในเนื้อหาหลักของเอกสารจะเป็นสีเทา ซึ่งบ่งชี้ว่าอ็อบเจ็กต์เหล่านี้แยกออกจากเนื้อหาอื่นๆ ของหน้าโดยสิ้นเชิง และการดำเนินการที่คุณดำเนินการกับอ็อบเจ็กต์เหล่านี้จะเฉพาะเจาะจงกับพื้นที่เหล่านี้ ในบทความนี้ เราจะเรียนรู้ขั้นตอนในการเพิ่มหรืออัปเดตส่วนหัวและส่วนท้ายในเอกสาร Word โดยใช้ REST API

API การประมวลผลคำ

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

นอกจากนี้ API ยังช่วยให้คุณกำหนดข้อมูลการจัดรูปแบบ เช่น คุณสมบัติของแบบอักษรและย่อหน้าสำหรับข้อความส่วนหัว/ส่วนท้ายได้ นอกจากนี้ คุณยังสามารถแทรกหมายเลขหน้าแบบไดนามิกลงในส่วนหัว/ส่วนท้ายได้อีกด้วย สุดท้ายแต่ไม่ท้ายสุด คุณอาจลองใช้ตารางออบเจ็กต์เพื่อให้ข้อความส่วนหัว/ส่วนท้ายส่วนหนึ่งจัดชิดขอบซ้ายและอีกส่วนหนึ่งชิดขอบขวา

ขอบเขตของบทความ

Aspose.Words Cloud SDK for .NET ของเราช่วยให้คุณทำงานกับ Aspose.Words Cloud REST APIs ได้อย่างรวดเร็วและง่ายดาย เนื่องจากช่วยจัดการรายละเอียดระดับล่างจำนวนมากเกี่ยวกับการสร้างคำขอและการจัดการการตอบกลับ และช่วยให้คุณสามารถเน้นที่การเขียนโค้ดเฉพาะตามความต้องการทางธุรกิจของคุณได้ ในบทความนี้ เราจะใช้ Aspose.Words Cloud SDK for .NET ใน Visual Studio สำหรับ Mac โพสต์นี้จะอธิบายขั้นตอนในการแทรกส่วนหัวและส่วนท้ายในเอกสาร Word โดยจะกำหนดการจัดรูปแบบแบบกำหนดเอง จากนั้นจะอัปเดตการจัดรูปแบบของเนื้อหาส่วนท้ายที่มีอยู่และข้อมูล PageNumber จะถูกแทรกที่ตำแหน่งด้านล่างขวา การดำเนินการทั้งหมดนี้จะดำเนินการในระบบคลาวด์

การติดตั้ง

ในการเริ่มต้น คุณต้องติดตั้ง Visual Studio ในระบบก่อน สร้างโซลูชันตัวอย่างและเพิ่มการอ้างอิง NuGet ของ Aspose.Words Cloud SDK for .NET ดังนั้นหากต้องการเพิ่มการอ้างอิง ให้คลิกขวาที่โซลูชันแล้วเลือกตัวเลือกเมนู Manage NuGet Packages… ป้อน Aspose.Words-Cloud ในช่องข้อความค้นหา เลือกตัวเลือกแล้วคลิกปุ่ม Add package

ตอนนี้การอ้างอิง Aspose.Words.Cloud.Sdk ปรากฏในโซลูชันแล้ว การใช้ API บนคลาวด์มีข้อดีบางประการเมื่อเทียบกับ API ในสถานที่ (aspose.com) เหตุผลก็คือ คุณไม่จำเป็นต้องติดตามและอัปเดตเวอร์ชัน API ด้วยตนเอง และคุณไม่จำเป็นต้องจ่ายเงินสำหรับใบอนุญาตทั้งหมด

แผงควบคุม Aspose.Cloud

เพียงสร้างบัญชีบน แดชบอร์ด Aspose.Cloud หรือลงทะเบียนผ่านบัญชี Google หรือ GitHub ที่มีอยู่ของคุณ และเริ่มใช้ Cloud API ของเรา คุณสมบัติที่น่าทึ่งอีกประการหนึ่งของ Cloud API คือคุณสามารถใช้บนแพลตฟอร์มใดก็ได้โดยใช้ภาษาที่รองรับใดก็ได้

ตามที่ระบุไว้ข้างต้น บทความนี้เน้นย้ำถึงตัวเลือกเกี่ยวกับการเพิ่มและอัปเดตวัตถุส่วนหัวและส่วนท้ายในเอกสาร MS Word เพื่อประโยชน์ในการทดสอบ เราได้ใช้เทมเพลตเอกสาร MS Word ที่มีอยู่แล้วซึ่งมีชื่อว่า Business Letter เอกสารจะต้องถูกอัปโหลดไปยังที่เก็บข้อมูลบนคลาวด์ของ Aspose และการจัดการและการประมวลผลเอกสารทั้งหมดจะดำเนินการผ่านคลาวด์ เมื่อการประมวลผลทั้งหมดเสร็จสมบูรณ์แล้ว เรายังสามารถดาวน์โหลดสำเนาไฟล์ที่ได้มาจากที่เก็บข้อมูลบนคลาวด์ได้อีกด้วย

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

ในการใช้ Aspose.Cloud API คุณต้องใช้ข้อมูล App Key และ App SID ในโค้ดของคุณ คีย์เหล่านี้ประกอบด้วยตัวเลขและตัวอักษร ซึ่งเป็นรหัสเฉพาะที่เชื่อมโยงกับบัญชีการสมัครใช้งานของคุณ หากต้องการรายละเอียดเหล่านี้ โปรดคลิกที่แท็บ My Apps บน Aspose.Cloud Dashboard เมื่อเรามีคีย์แล้ว เราต้องเริ่มต้นวัตถุ Aspose.Words API

string MyAppKey = "f6axxxxxxxxxxxxxxxxxx";     // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "478e4827-xxxxx-xxxx-xxxx-xxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// create an object of WordsApi while passing AppKey and AppSid information
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

แทรกวัตถุส่วนหัว

เพื่อที่จะเพิ่มวัตถุส่วนหัวภายในไฟล์ MS Word เราจะต้องดำเนินการดังต่อไปนี้ตามลำดับ

  1. สร้างอ็อบเจ็กต์ของ InsertHeaderFooterRequest โดยที่เราส่งประเภท HeaderFooterLink เป็นอาร์กิวเมนต์
  2. แทรกวัตถุ HeaderFooterRequest ลงในวัตถุ WordsApi โดยใช้เมธอด InsertHeaderFooter (…)
  3. สร้างวัตถุ Run ซึ่งถือข้อมูลตัวอย่างข้อความ
  4. สร้างอ็อบเจ็กต์ InsertRunRequest โดยที่เราส่งการอ้างอิงของย่อหน้า (SectionPath) ในอ็อบเจ็กต์ HeaderFooter โดยที่ต้องเพิ่มข้อความ Run
    จากนั้นเรียกวิธี InsertRun (…) ของ WordsApi ซึ่งจะเพิ่ม RunRequest ลงในอ็อบเจ็กต์ HeaderFooter

HeaderFooter.TypeEnum สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// สร้างวัตถุของ WordsAPI ขณะส่งข้อมูล AppKey และ AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// อัพโหลดเอกสารตัวอย่างไปยังที่เก็บข้อมูลบนคลาวด์
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// แทรกวัตถุส่วนหัวในหน้าแรก
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);  
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// สร้างวัตถุ Run ที่ประกอบด้วยข้อความตัวอย่าง
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// เพิ่มข้อความ Run ลงในย่อหน้าแรกของวัตถุ HeaderFooter แรกในส่วนแรกของเอกสาร Word
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// แทรก RunRequest ลงในเอกสาร Word
var actual2 = wordsApi.InsertRun(runRequest);

อัปเดตการจัดรูปแบบข้อความของส่วนหัวที่แทรกใหม่

เมื่อเพิ่มวัตถุ Header แล้ว เราสามารถอัปเดตการจัดรูปแบบข้อความของเนื้อหาภายในวัตถุได้ เพื่อตอบสนองความต้องการนี้ เราต้องดำเนินการตามขั้นตอนต่อไปนี้

  1. สร้างอ็อบเจ็กต์ของคลาส Font โดยเราจะระบุชื่อ Font ขนาด ข้อมูลสี
  2. เพื่อให้ข้อความนำเสนอได้สะดวกยิ่งขึ้น ให้ทำเครื่องหมายคุณสมบัติแกะสลักเป็น True
  3. สร้างอ็อบเจ็กต์ของคลาส UpdateRunFontRequest โดยที่เราส่งไฟล์อินพุต Font, SectionPath และ runIndex เป็นอาร์กิวเมนต์
  4. สุดท้าย ให้ใช้เมธอด UpdateRunFont(..) และเพิ่มอ็อบเจ็กต์ UpdateRunFontRequest ลงในอินสแตนซ์ WordsApi
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// สร้างวัตถุของ WordsAPI ขณะส่งข้อมูล AppKey และ AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// อัพโหลดเอกสารตัวอย่างไปยังที่เก็บข้อมูลบนคลาวด์
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// ขั้นตอนต่อไปคือการกำหนดรูปแบบของวัตถุส่วนหัว
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
//  ตั้งค่าการจัดรูปแบบข้อความเป็นแกะสลัก
fontDto.Engrave = true;
// ใช้การจัดรูปแบบกับย่อหน้าแรกของวัตถุ HeaderFooter
var documentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
    fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual4 = wordsApi.UpdateRunFont(documentParagraphRunFontRequest);

API ยังนำเสนอคุณสมบัติในการอัปเดตการจัดรูปแบบของเนื้อหาภายในอ็อบเจ็กต์ Header / Footer ที่มีอยู่ เพื่อตอบสนองความต้องการนี้ เราสามารถใช้บรรทัดโค้ดที่ระบุไว้ข้างต้นได้ แต่ความแตกต่างเพียงอย่างเดียวคือการเปลี่ยนดัชนี headerfooter เป็น 2 โปรดดูบรรทัดโค้ดต่อไปนี้

// Apply formatting to first paragraph of HeaderFooter object
var FooterDocumentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx", 
FooterFontDto, "sections/0/headersfooters/2/paragraphs/0", FooterrunIndex);

เพิ่มข้อมูลหมายเลขหน้าในส่วนท้าย

หมายเลขหน้าให้ข้อมูลที่มีประโยชน์มาก เช่น หน้าปัจจุบันและจำนวนหน้าทั้งหมดในเอกสาร ขั้นตอนต่อไปนี้จะกำหนดวิธีการปฏิบัติตามข้อกำหนด

  1. ขั้นแรก ให้สร้างอ็อบเจ็กต์ของคลาส PageNumber โดยที่เราจะได้กำหนด การจัดตำแหน่งของข้อความ รูปแบบของข้อความ ตำแหน่งในการแสดงข้อมูล PageNumber และระบุด้วยว่าจำเป็นต้องแสดง PageNumber ในหน้าแรกหรือไม่
  2. สร้างวัตถุ InsertPageNumbersRequest และส่งวัตถุ PageNumber เป็นอาร์กิวเมนต์
  3. ในที่สุด เรียกวิธี InsertPageNumbers(..) เพื่อเพิ่ม InsertPageNumbersRequest ลงในอินสแตนซ์ WordsApi
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// สร้างวัตถุของ WordsAPI ขณะส่งข้อมูล AppKey และ AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// อัพโหลดเอกสารตัวอย่างไปยังที่เก็บข้อมูลบนคลาวด์
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// API ยังให้คุณสมบัติในการเพิ่มรายละเอียดหมายเลขหน้าในอ็อบเจ็กต์ HeaderFooter อีกด้วย
// เพิ่มข้อมูลหมายเลขหน้าทางด้านขวาล่างของหน้า
var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = false, SetPageNumberOnFirstPage = true };
var insertPageNumbersRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertPageNumbersRequest("BusinessLetter.docx", body);
// แทรกข้อมูลหมายเลขหน้าลงในเอกสาร Word
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);

บทสรุป

ในบทความนี้ เราได้เรียนรู้ขั้นตอนในการเพิ่มส่วนหัวและส่วนท้ายในเอกสาร Word โดยใช้ Aspose.Words Cloud SDK for .NET โปรดทราบว่าเรายังมี Cloud SDK สำหรับ Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android สำหรับรายละเอียดเพิ่มเติม โปรดไปที่ Aspose.Words Cloud

บทความที่เกี่ยวข้อง

เราขอแนะนำให้เยี่ยมชมเว็บไซต์ต่อไปนี้เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ