Pelacakan Kemajuan Konversi Dokumen Secara Terprogram di .NET

Perkenalan

Apakah Anda ingin meningkatkan proses konversi dokumen Anda menggunakan Aspose.Cells for .NET? Jika demikian, Anda berada di tempat yang tepat! Dalam tutorial ini, kita akan menyelami lebih dalam pelacakan kemajuan konversi dokumen Excel saat diubah ke format PDF. Kami tidak hanya akan memandu Anda melalui langkah-langkah penting untuk mencapainya, tetapi kami juga akan memberikan beberapa wawasan bermanfaat di sepanjang prosesnya. Jadi, mari kita mulai!

Prasyarat

Sebelum kita masuk ke inti pelacakan konversi dokumen, ada beberapa prasyarat yang harus Anda penuhi:

1. Pengetahuan Dasar C#: Karena kita akan menggunakan C# untuk membuat kode, pemahaman dasar tentang bahasa pemrograman ini akan berguna.
2. Visual Studio Terpasang: Ini akan berfungsi sebagai lingkungan pengembangan kami. Anda dapat menggunakan versi apa pun yang Anda inginkan, tetapi versi terbaru selalu merupakan pilihan yang baik.
3. Aspose.Cells untuk .NET: Pastikan Anda telah menginstal Aspose.Cells. Anda dapat mengunduhnya dariSitus web Aspose.
4. File Excel: Siapkan contoh file Excel yang siap dikonversi. Anda dapat membuat file Excel sederhana.xlsx berkas untuk diikuti.

Paket Impor

Setelah prasyarat terpenuhi, saatnya mengimpor paket yang diperlukan ke proyek C# Anda. Berikut cara melakukannya:

Buat Proyek Baru

1. Buka Visual Studio dan buat proyek baru. Pilih templat Aplikasi Konsol untuk mempermudah.

Tambahkan Referensi ke Aspose.Cells

2. Klik kanan pada References di Solution Explorer, pilih Add Reference, dan navigasikan ke assembly Aspose.Cells jika tidak ditambahkan secara otomatis. Anda juga dapat menggunakan NuGet Package Manager dengan menjalankan perintah berikut di Package Manager Console:

Install-Package Aspose.Cells

Mengimpor Ruang Nama

3. Di bagian atas AndaProgram.cs file, tambahkan perintah berikut menggunakan:

using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Sekarang kita sudah siap dengan pengaturan proyek kita!

Setelah dasar-dasarnya tersusun, mari kita uraikan proses sebenarnya pelacakan konversi dokumen ke dalam langkah-langkah yang mudah dipahami.

Langkah 1: Tentukan Direktori Anda

Mulailah dengan menentukan direktori tempat file sumber dan output akan berada. Berikut cara melakukannya:

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

Pastikan untuk mengganti"Your Document Directory" dengan jalur sebenarnya pada sistem Anda. Ini akan membantu menemukan berkas Anda dengan mudah.

Langkah 2: Muat Buku Kerja

Selanjutnya, Anda perlu memuat buku kerja Excel Anda menggunakanWorkbook kelas. Begini caranya:

Workbook workbook = new Workbook(sourceDir + "PagesBook1.xlsx");

Baris kode ini membuatWorkbook objek yang akan memungkinkan kita berinteraksi dengan file Excel yang kita tentukan.

Langkah 3: Siapkan Opsi Penyimpanan PDF

Sekarang, mari kita atur opsi penyimpanan PDF. Di sinilah keajaiban pelacakan kemajuan dimulai. Anda akan membuat contohPdfSaveOptions dan menetapkan panggilan balik padanya.

PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
pdfSaveOptions.PageSavingCallback = new TestPageSavingCallback();

Dengan menetapkan panggilan balik khusus (TestPageSavingCallback), kita dapat menerapkan logika kita sendiri untuk melacak kemajuan konversi halaman.

Langkah 4: Simpan Buku Kerja sebagai PDF

Setelah semuanya siap, saatnya menyimpan buku kerja Anda sebagai PDF. GunakanSave metode dariWorkbook kelas seperti ini:

workbook.Save(outputDir + "DocumentConversionProgress.pdf", pdfSaveOptions);

Baris ini akan memicu proses konversi dan memanggil metode panggilan balik kami saat halaman sedang diproses.

Langkah 5: Terapkan Kelas Panggilan Balik

Sekarang mari kita buatTestPageSavingCallback kelas. Di sinilah Anda menentukan apa yang terjadi di awal dan akhir penyimpanan setiap halaman.

public class TestPageSavingCallback : IPageSavingCallback
{
    public void PageStartSaving(PageStartSavingArgs args)
    {
        Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Jangan keluarkan halaman sebelum indeks halaman 2.
        if (args.PageIndex < 2)
        {
            args.IsToOutput = false;
        }
    }
    public void PageEndSaving(PageEndSavingArgs args)
    {
        Console.WriteLine("End saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Jangan keluarkan halaman setelah indeks halaman 8.
        if (args.PageIndex >= 8)
        {
            args.HasMorePages = false;
        }
    }
}

• PageStartSavingMetode ini dipanggil sebelum halaman mulai disimpan. Di sini, kami mencatat dimulainya proses penyimpanan untuk setiap halaman. Selain itu, kami dapat mengontrol apakah akan menampilkan halaman atau tidak. Dalam kasus ini, halaman sebelum indeks 2 dilewati.
• PageEndSaving: Metode ini dipanggil setelah halaman disimpan. Metode ini memungkinkan Anda untuk mencatat kapan halaman disimpan untuk setiap halaman dan mengontrol apakah halaman lain harus diproses. Dalam contoh ini, kita berhenti setelah indeks halaman 8.

Kesimpulan

Selamat! Anda telah berhasil menerapkan sistem untuk melacak kemajuan konversi dokumen menggunakan Aspose.Cells for .NET. Pendekatan ini tidak hanya memungkinkan Anda untuk memantau proses konversi tetapi juga memberi Anda kendali atas halaman mana yang akan disertakan atau dikecualikan, sehingga pengelolaan dokumen Anda menjadi jauh lebih efisien.

Pertanyaan yang Sering Diajukan

Apa itu Aspose.Cells?

Aspose.Cells adalah pustaka .NET canggih yang memungkinkan pengembang untuk membuat, memanipulasi, dan mengonversi file Excel secara terprogram.

Bagaimana saya bisa mendapatkan uji coba Aspose.Cells gratis?

Anda dapat mengunduh uji coba gratis dariSitus web Aspose.

Apakah mungkin untuk menyesuaikan proses konversi?

Ya, dengan menggunakan panggilan balik, Anda dapat menyesuaikan bagaimana halaman diproses selama konversi.

Bisakah saya mengontrol nama file keluaran?

Tentu saja! Anda dapat menentukan nama apa pun untuk berkas keluaran saat menyimpan buku kerja.

Di mana saya dapat menemukan dukungan untuk Aspose.Cells?

Anda bisa mendapatkan dukungan dengan mengunjungiForum Aspose.