Kontrol Sumber Daya Eksternal dengan Aspose.Cells untuk .NET

Perkenalan

Dalam lanskap digital saat ini, mengonversi lembar kerja Excel ke dokumen PDF merupakan tugas yang umum dan penting. Baik Anda sedang mempersiapkan laporan, data keuangan, atau materi presentasi, memastikan bahwa PDF Anda mencerminkan format yang Anda inginkan sangatlah penting. Aspose.Cells untuk .NET menyediakan pustaka canggih yang memungkinkan Anda untuk mengontrol proses konversi ini secara terperinci, terutama saat menangani sumber daya eksternal seperti gambar. Dalam panduan ini, kita akan membahas cara mengelola sumber daya eksternal secara efektif selama proses konversi Excel ke PDF menggunakan Aspose.Cells. Mari kita bahas!

Prasyarat

Sebelum kita mulai, pastikan Anda telah menyiapkan hal berikut:

1. Visual Studio atau IDE apa pun yang kompatibel dengan .NET: Ini akan menjadi lingkungan pengembangan Anda.
2. Aspose.Cells untuk .NET: Jika Anda belum menginstalnya, kunjungiUnduhan Aspose halaman untuk mendapatkan versi terbaru.
3. Pengetahuan Dasar tentang C#: Pemahaman terhadap C# akan sangat bermanfaat. Jika Anda memerlukan klarifikasi tentang konsep apa pun, silakan mencarinya.
4. Contoh File Excel: Siapkan file Excel, seperti “samplePdfSaveOptions_StreamProvider.xlsx,” yang berisi sumber daya eksternal yang ingin Anda konversi.
5. File Gambar untuk Pengujian: Gunakan file gambar seperti “newPdfSaveOptions_StreamProvider.png” sebagai sumber daya eksternal selama konversi.

Impor Paket yang Diperlukan

Untuk memulai, Anda perlu mengimpor namespace yang diperlukan dari pustaka Aspose.Cells. Tambahkan perintah berikut di bagian atas berkas C# Anda:

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

Ruang nama ini menyediakan kelas dan metode penting untuk tugas Anda.

Langkah 1: Buat Kelas Penyedia Aliran

Pertama, buat kelas penyedia aliran yang mengimplementasikanIStreamProvider antarmuka. Kelas ini akan memungkinkan Anda untuk mengontrol bagaimana sumber daya eksternal dimuat.

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-----");
        
        // Memuat gambar ke dalam aliran memori
        byte[] bts = File.ReadAllBytes(Path.Combine(sourceDir, "newPdfSaveOptions_StreamProvider.png"));
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

• CloseStream: Metode ini dipanggil saat aliran ditutup, saat ini sedang mencatat pesan debug.
• InitStream: Metode ini membaca file gambar eksternal sebagai array byte, mengubahnya menjadi aliran memori, dan menetapkannya keoptions.Stream milik.

Langkah 2: Siapkan Direktori Sumber dan Output

Berikutnya, tentukan direktori untuk file Excel dan PDF keluaran.

// Direktori sumber
string sourceDir = "Your Document Directory";
// Direktori keluaran
string outputDir = "Your Document Directory";

Mengganti"Your Document Directory" dengan jalur sebenarnya pada sistem Anda di mana file Anda berada.

Langkah 3: Muat File Excel Anda

Sekarang, muat berkas Excel yang ingin Anda gunakan untuk membuat PDF.

// Muat file Excel sumber yang berisi gambar eksternal
Workbook wb = new Workbook(sourceDir, "samplePdfSaveOptions_StreamProvider.xlsx");

ItuWorkbook kelas dari Aspose.Cells mewakili file Excel Anda, yang mungkin menyertakan berbagai sumber daya eksternal seperti gambar.

Langkah 4: Atur Opsi Penyimpanan PDF

Sebelum menyimpan buku kerja sebagai PDF, tentukan opsi penyimpanan yang Anda inginkan.

// Tentukan Opsi Penyimpanan PDF - Penyedia Aliran
PdfSaveOptions opts = new PdfSaveOptions
{
    OnePagePerSheet = true // Simpan setiap lembar di halaman baru
};

Ini menciptakan contohPdfSaveOptions , memungkinkan Anda untuk menyesuaikan format PDF.OnePagePerSheet opsi memastikan bahwa setiap lembar Excel muncul pada halaman terpisah dalam PDF final.

Langkah 5: Tetapkan Penyedia Streaming Anda

Hubungkan AndaWorkbook contoh denganMyStreamProvider kelas yang Anda buat sebelumnya.

wb.Settings.StreamProvider = new MyStreamProvider();

Baris ini memastikan bahwa setiap kali sumber daya eksternal ditemukan selama konversi, penyedia kustom Anda akan mengelolanya sebagaimana mestinya.

Langkah 6: Simpan Buku Kerja sebagai PDF

Sekarang, simpan buku kerja Excel Anda sebagai PDF.

// Simpan buku kerja ke PDF
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

Dengan meneleponSave metode pada objek buku kerja dan meneruskan direktori keluaran beserta opsi PDF, Anda mengonversi file Excel menjadi PDF yang diformat dengan baik.

Langkah 7: Konfirmasikan Eksekusi yang Berhasil

Terakhir, ada baiknya untuk mengonfirmasi apakah proses telah berhasil diselesaikan.

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

Pesan ini akan memberi tahu Anda tentang status operasi Anda dan memberikan umpan balik yang bermanfaat.

Kesimpulan

Anda kini telah menguasai proses pengendalian sumber daya eksternal selama konversi Excel ke PDF menggunakan Aspose.Cells! Dengan mengikuti langkah-langkah ini, Anda dapat memastikan bahwa dokumen Anda secara akurat menyertakan gambar dan elemen eksternal lainnya, sehingga menghasilkan produk akhir yang sempurna setiap saat.

Pertanyaan yang Sering Diajukan

Apa itu Aspose.Cells?

Aspose.Cells adalah pustaka hebat untuk pengembang .NET yang memungkinkan pembuatan, manipulasi, konversi, dan rendering file Excel dalam berbagai format.

Bagaimana cara mengunduh Aspose.Cells?

Anda dapat mengunduh versi terbaru dariTautan unduhan.

Dapatkah saya mencoba Aspose.Cells secara gratis?

Ya! Anda dapat mengakses uji coba gratis dengan mengunjungiHalaman uji coba gratis.

Di mana saya dapat menemukan dukungan untuk Aspose.Cells?

Untuk pertanyaan terkait dukungan, kunjungiForum Dukungan Aspose.

Bagaimana cara memperoleh lisensi sementara untuk Aspose.Cells?

Anda dapat mengajukan permohonan lisensi sementaraDi Sini.