ควบคุมทรัพยากรภายนอกด้วย Aspose.Cells สำหรับ .NET

การแนะนำ

ในภูมิทัศน์ดิจิทัลของปัจจุบัน การแปลงสเปรดชีต Excel เป็นเอกสาร PDF ถือเป็นงานทั่วไปและจำเป็น ไม่ว่าคุณจะกำลังเตรียมรายงาน ข้อมูลทางการเงิน หรือเอกสารนำเสนอ การทำให้มั่นใจว่า PDF ของคุณสะท้อนถึงรูปแบบที่คุณต้องการถือเป็นสิ่งสำคัญ Aspose.Cells สำหรับ .NET มีไลบรารีอันทรงพลังที่ช่วยให้คุณควบคุมกระบวนการแปลงนี้ได้อย่างละเอียด โดยเฉพาะเมื่อต้องจัดการกับทรัพยากรภายนอก เช่น รูปภาพ ในคู่มือนี้ เราจะมาสำรวจวิธีการจัดการทรัพยากรภายนอกอย่างมีประสิทธิภาพระหว่างกระบวนการแปลง Excel เป็น PDF โดยใช้ Aspose.Cells มาเริ่มกันเลย!

ข้อกำหนดเบื้องต้น

ก่อนที่เราจะเริ่ม ให้แน่ใจว่าคุณมีสิ่งต่อไปนี้พร้อมแล้ว:

  1. Visual Studio หรือ IDE ที่เข้ากันได้กับ .NET: นี่จะเป็นสภาพแวดล้อมการพัฒนาของคุณ
  2. Aspose.Cells สำหรับ .NET: หากคุณยังไม่ได้ติดตั้ง โปรดไปที่ดาวน์โหลด Aspose หน้าเพื่อรับเวอร์ชั่นล่าสุด
  3. ความรู้พื้นฐานเกี่ยวกับ C#: ความคุ้นเคยกับ C# จะเป็นประโยชน์ หากคุณต้องการคำชี้แจงเกี่ยวกับแนวคิดใดๆ โปรดค้นหา
  4. ตัวอย่างไฟล์ Excel: เตรียมไฟล์ Excel เช่น “samplePdfSaveOptions_StreamProvider.xlsx” ที่มีทรัพยากรภายนอกที่คุณต้องการแปลง
  5. ไฟล์รูปภาพสำหรับการทดสอบ: ใช้ไฟล์รูปภาพเช่น “newPdfSaveOptions_StreamProvider.png” เป็นทรัพยากรภายนอกในระหว่างการแปลง

แพ็คเกจนำเข้าที่จำเป็น

ในการเริ่มต้น คุณจะต้องนำเข้าเนมสเปซที่จำเป็นจากไลบรารี Aspose.Cells เพิ่มคำสั่ง using ต่อไปนี้ที่ด้านบนของไฟล์ C# ของคุณ:

using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;
using System;

เนมสเปซเหล่านี้ให้คลาสและวิธีการที่จำเป็นสำหรับงานของคุณ

ขั้นตอนที่ 1: สร้างคลาสผู้ให้บริการสตรีม

ขั้นแรก ให้สร้างคลาสผู้ให้บริการสตรีมที่ใช้งานIStreamProvider อินเทอร์เฟซ คลาสนี้จะช่วยให้คุณสามารถควบคุมวิธีการโหลดทรัพยากรภายนอกได้

class MyStreamProvider : IStreamProvider
{
    public void CloseStream(StreamProviderOptions options)
    {
        Debug.WriteLine("-----Close Stream-----");
    }

    public void InitStream(StreamProviderOptions options)
    {
        string sourceDir = "Your Document Directory";
        Debug.WriteLine("-----Init Stream-----");
        
        // โหลดภาพลงในสตรีมหน่วยความจำ
        byte[] bts = File.ReadAllBytes(Path.Combine(sourceDir, "newPdfSaveOptions_StreamProvider.png"));
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}
  • CloseStream: วิธีการนี้ถูกเรียกเมื่อสตรีมถูกปิด โดยปัจจุบันกำลังบันทึกข้อความการดีบัก
  • InitStream: วิธีนี้จะอ่านไฟล์รูปภาพภายนอกเป็นอาร์เรย์ไบต์ แปลงเป็นสตรีมหน่วยความจำ และกำหนดให้กับoptions.Stream คุณสมบัติ.

ขั้นตอนที่ 2: ตั้งค่าไดเร็กทอรีแหล่งที่มาและเอาต์พุต

จากนั้นกำหนดไดเร็กทอรีสำหรับไฟล์ Excel และเอาท์พุต PDF

// ไดเรกทอรีแหล่งที่มา
string sourceDir = "Your Document Directory";
// ไดเรกทอรีผลลัพธ์
string outputDir = "Your Document Directory";

แทนที่"Your Document Directory" ด้วยเส้นทางจริงบนระบบของคุณซึ่งไฟล์ของคุณตั้งอยู่

ขั้นตอนที่ 3: โหลดไฟล์ Excel ของคุณ

ตอนนี้โหลดไฟล์ Excel ที่คุณต้องการสร้าง PDF

// โหลดไฟล์ Excel ต้นฉบับที่มีรูปภาพภายนอก
Workbook wb = new Workbook(sourceDir, "samplePdfSaveOptions_StreamProvider.xlsx");

การWorkbook คลาสจาก Aspose.Cells แสดงถึงไฟล์ Excel ของคุณ ซึ่งอาจมีทรัพยากรภายนอกต่างๆ เช่น รูปภาพ

ขั้นตอนที่ 4: ตั้งค่าตัวเลือกการบันทึก PDF

ก่อนบันทึกสมุดงานเป็น PDF โปรดระบุตัวเลือกการบันทึกที่คุณต้องการ

// ระบุตัวเลือกการบันทึก PDF - ผู้ให้บริการสตรีม
PdfSaveOptions opts = new PdfSaveOptions
{
    OnePagePerSheet = true // บันทึกแต่ละแผ่นในหน้าใหม่
};

นี่จะสร้างอินสแตนซ์ของPdfSaveOptions ช่วยให้คุณปรับแต่งรูปแบบ PDF ได้OnePagePerSheet ตัวเลือกนี้ทำให้แน่ใจว่าแผ่นงาน Excel แต่ละแผ่นจะปรากฏในหน้าแยกใน PDF ขั้นสุดท้าย

ขั้นตอนที่ 5: กำหนดผู้ให้บริการสตรีมของคุณ

เชื่อมต่อของคุณWorkbook ตัวอย่างด้วยMyStreamProvider ชั้นเรียนที่คุณสร้างไว้ก่อนหน้านี้

wb.Settings.StreamProvider = new MyStreamProvider();

บรรทัดนี้จะช่วยให้แน่ใจว่าเมื่อใดก็ตามที่พบทรัพยากรภายนอกระหว่างการแปลง ผู้ให้บริการที่คุณกำหนดเองจะจัดการทรัพยากรเหล่านั้นตามนั้น

ขั้นตอนที่ 6: บันทึกสมุดงานเป็น PDF

ตอนนี้ให้บันทึกเวิร์กบุ๊ก Excel ของคุณเป็น PDF

// บันทึกสมุดงานเป็น PDF
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

โดยการโทรหาSave วิธีการบนวัตถุเวิร์กบุ๊กและส่งไดเรกทอรีเอาต์พุตพร้อมกับตัวเลือก PDF คุณจะแปลงไฟล์ Excel เป็น PDF ที่มีการจัดรูปแบบที่ดี

ขั้นตอนที่ 7: ยืนยันการดำเนินการสำเร็จ

สุดท้ายนี้ ถือเป็นการปฏิบัติที่ดีในการยืนยันว่ากระบวนการเสร็จสมบูรณ์แล้ว

Console.WriteLine("ControlLoadingOfExternalResourcesInExcelToPDF executed successfully.\r\n");

ข้อความนี้จะแจ้งให้คุณทราบถึงสถานะการดำเนินการของคุณ และให้ข้อเสนอแนะที่มีประโยชน์

บทสรุป

ตอนนี้คุณได้เชี่ยวชาญกระบวนการควบคุมทรัพยากรภายนอกระหว่างการแปลง Excel เป็น PDF โดยใช้ Aspose.Cells แล้ว! เมื่อทำตามขั้นตอนเหล่านี้ คุณจะมั่นใจได้ว่าเอกสารของคุณมีรูปภาพและองค์ประกอบภายนอกอื่นๆ อย่างถูกต้อง ส่งผลให้ผลิตภัณฑ์ขั้นสุดท้ายออกมาสมบูรณ์แบบทุกครั้ง

คำถามที่พบบ่อย

Aspose.Cells คืออะไร?

Aspose.Cells เป็นไลบรารีอันทรงพลังสำหรับนักพัฒนา .NET ซึ่งช่วยให้สามารถสร้าง จัดการ แปลง และเรนเดอร์ไฟล์ Excel ในรูปแบบต่างๆ ได้

ฉันจะดาวน์โหลด Aspose.Cells ได้อย่างไร?

คุณสามารถดาวน์โหลดเวอร์ชันล่าสุดได้จากลิงค์ดาวน์โหลด.

ฉันสามารถทดลองใช้ Aspose.Cells ฟรีได้หรือไม่?

ใช่! คุณสามารถเข้าถึงการทดลองใช้ฟรีได้โดยเข้าไปที่หน้าทดลองใช้งานฟรี.

ฉันสามารถค้นหาการสนับสนุนสำหรับ Aspose.Cells ได้ที่ไหน

สำหรับคำถามที่เกี่ยวข้องกับการสนับสนุน โปรดไปที่ฟอรั่มสนับสนุน Aspose.

ฉันจะขอใบอนุญาตชั่วคราวสำหรับ Aspose.Cells ได้อย่างไร

คุณสามารถสมัครขอใบอนุญาตชั่วคราวได้ที่นี่.