Παρακολούθηση της προόδου μετατροπής εγγράφου μέσω προγραμματισμού στο .NET

Εισαγωγή

Θέλετε να βελτιώσετε τη διαδικασία μετατροπής εγγράφων χρησιμοποιώντας το Aspose.Cells για .NET; Αν ναι, είστε στο σωστό μέρος! Σε αυτό το σεμινάριο, θα βουτήξουμε βαθιά στην παρακολούθηση της προόδου μετατροπής των εγγράφων του Excel καθώς μετατρέπονται σε μορφή PDF. Όχι μόνο θα σας καθοδηγήσουμε στα βασικά βήματα για να το πετύχετε αυτό, αλλά θα δώσουμε επίσης μερικές χρήσιμες πληροφορίες στην πορεία. Λοιπόν, ας ξεκινήσουμε!

Προαπαιτούμενα

Προτού περάσουμε στη βασική διαδικασία της μετατροπής εγγράφων παρακολούθησης, υπάρχουν μερικές προϋποθέσεις που πρέπει να έχετε:

  1. Βασικές γνώσεις C#: Εφόσον θα χρησιμοποιήσουμε το C# για να κωδικοποιήσουμε, η βασική κατανόηση αυτής της γλώσσας προγραμματισμού θα είναι χρήσιμη.
  2. Εγκαταστάθηκε το Visual Studio: Αυτό θα χρησιμεύσει ως περιβάλλον ανάπτυξης. Μπορείτε να χρησιμοποιήσετε οποιαδήποτε έκδοση προτιμάτε, αλλά η πιο πρόσφατη είναι πάντα μια καλή επιλογή.
  3. Aspose.Cells για .NET: Βεβαιωθείτε ότι έχετε εγκαταστήσει το Aspose.Cells. Μπορείτε να το κατεβάσετε από τοAspose website.
  4. Ένα αρχείο Excel: Έχετε ένα δείγμα αρχείου Excel έτοιμο για μετατροπή. Μπορείτε να δημιουργήσετε ένα απλό.xlsx αρχείο για να ακολουθήσει.

Εισαγωγή πακέτων

Τώρα που έχουμε καλύψει τις προϋποθέσεις μας, ήρθε η ώρα να εισαγάγετε τα απαραίτητα πακέτα στο έργο σας C#. Δείτε πώς να το κάνετε:

Δημιουργία Νέου Έργου

  1. Ανοίξτε το Visual Studio και δημιουργήστε ένα νέο έργο. Επιλέξτε ένα πρότυπο εφαρμογής Κονσόλας για απλότητα.

Προσθήκη αναφοράς στο Aspose.Cells

  1. Κάντε δεξί κλικ στις αναφορές στην Εξερεύνηση λύσεων, επιλέξτε Προσθήκη αναφοράς και μεταβείτε στη διάταξη Aspose.Cells εάν δεν προστίθεται αυτόματα. Μπορείτε επίσης να χρησιμοποιήσετε το NuGet Package Manager εκτελώντας την ακόλουθη εντολή στην Κονσόλα Package Manager:
Install-Package Aspose.Cells

Εισαγωγή χώρων ονομάτων

  1. Στην κορυφή σουProgram.cs αρχείο, προσθέστε τα ακόλουθα χρησιμοποιώντας την οδηγία:
using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Τώρα είμαστε έτοιμοι με τη ρύθμιση του έργου μας!

Με τις βάσεις που έχουν τεθεί, ας αναλύσουμε την πραγματική διαδικασία παρακολούθησης της μετατροπής εγγράφων σε εύπεπτα βήματα.

Βήμα 1: Ορίστε τους καταλόγους σας

Ξεκινήστε καθορίζοντας τους καταλόγους στους οποίους θα βρίσκονται τα αρχεία προέλευσης και εξόδου. Δείτε πώς να το κάνετε:

// Κατάλογος πηγής
string sourceDir = "Your Document Directory";
// Κατάλογος εξόδου
string outputDir = "Your Document Directory";

Φροντίστε να αντικαταστήσετε"Your Document Directory" με την πραγματική διαδρομή στο σύστημά σας. Αυτό θα σας βοηθήσει να εντοπίσετε εύκολα τα αρχεία σας.

Βήμα 2: Φορτώστε το βιβλίο εργασίας

Στη συνέχεια, πρέπει να φορτώσετε το βιβλίο εργασίας του Excel χρησιμοποιώντας τοWorkbook τάξη. Δείτε πώς:

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

Αυτή η γραμμή κώδικα δημιουργεί έναWorkbook αντικείμενο που θα μας επιτρέψει να αλληλεπιδράσουμε με το αρχείο Excel που καθορίσαμε.

Βήμα 3: Ρύθμιση επιλογών αποθήκευσης PDF

Τώρα, ας ρυθμίσουμε τις επιλογές αποθήκευσης PDF. Εδώ αρχίζει η μαγεία της παρακολούθησης της προόδου. Θα δημιουργήσετε ένα παράδειγμα τουPdfSaveOptions και αντιστοιχίστε μια επανάκληση σε αυτό.

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

Εκχωρώντας μια προσαρμοσμένη επιστροφή κλήσης (TestPageSavingCallback), μπορούμε να εφαρμόσουμε τη δική μας λογική για την παρακολούθηση της προόδου μετατροπής σελίδας.

Βήμα 4: Αποθηκεύστε το βιβλίο εργασίας ως PDF

Με όλα τα ρυθμισμένα, ήρθε η ώρα να αποθηκεύσετε το βιβλίο εργασίας σας ως PDF. Χρησιμοποιήστε τοSave μέθοδος τουWorkbook τάξη όπως έτσι:

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

Αυτή η γραμμή θα ενεργοποιήσει τη διαδικασία μετατροπής και θα επικαλεστεί τις μεθόδους μας επανάκλησης καθώς οι σελίδες υποβάλλονται σε επεξεργασία.

Βήμα 5: Υλοποιήστε την κλάση επανάκλησης

Τώρα ας δημιουργήσουμε τοTestPageSavingCallback τάξη. Εδώ ορίζετε τι συμβαίνει στην αρχή και στο τέλος της αποθήκευσης κάθε σελίδας.

public class TestPageSavingCallback : IPageSavingCallback
{
    public void PageStartSaving(PageStartSavingArgs args)
    {
        Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Μην βγάζετε σελίδες πριν από το ευρετήριο σελίδας 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);
        // Μην βγάζετε σελίδες μετά το ευρετήριο 8.
        if (args.PageIndex >= 8)
        {
            args.HasMorePages = false;
        }
    }
}
  • PageStartSavingΑυτή η μέθοδος καλείται λίγο πριν ξεκινήσει η αποθήκευση μιας σελίδας. Εδώ, καταγράφουμε την έναρξη της διαδικασίας αποθήκευσης για κάθε σελίδα. Επιπλέον, μπορούμε να ελέγξουμε αν θα βγει η σελίδα ή όχι. Σε αυτήν την περίπτωση, οι σελίδες πριν από το ευρετήριο 2 παραλείπονται.
  • PageEndSaving: Αυτή η μέθοδος καλείται μετά την αποθήκευση μιας σελίδας. Σας επιτρέπει να καταγράφετε κατά την αποθήκευση των άκρων για κάθε σελίδα και να ελέγχετε εάν θα πρέπει να υποβάλλονται σε επεξεργασία περισσότερες σελίδες. Σε αυτό το παράδειγμα, σταματάμε μετά το ευρετήριο 8 της σελίδας.

Σύναψη

Συγχαρητήρια! Έχετε εφαρμόσει με επιτυχία ένα σύστημα παρακολούθησης της προόδου της μετατροπής εγγράφων χρησιμοποιώντας το Aspose.Cells για .NET. Αυτή η προσέγγιση όχι μόνο σάς επιτρέπει να παρακολουθείτε τη διαδικασία μετατροπής, αλλά σας δίνει επίσης τον έλεγχο του ποιες σελίδες να συμπεριλάβετε ή να εξαιρέσετε, κάνοντας τη διαχείριση των εγγράφων σας πολύ πιο αποτελεσματική.

Συχνές ερωτήσεις

Τι είναι το Aspose.Cells;

Το Aspose.Cells είναι μια ισχυρή βιβλιοθήκη .NET που επιτρέπει στους προγραμματιστές να δημιουργούν, να χειρίζονται και να μετατρέπουν αρχεία Excel μέσω προγραμματισμού.

Πώς μπορώ να αποκτήσω μια δωρεάν δοκιμή του Aspose.Cells;

Μπορείτε να κατεβάσετε μια δωρεάν δοκιμή από τοAspose website.

Είναι δυνατή η προσαρμογή της διαδικασίας μετατροπής;

Ναι, χρησιμοποιώντας τις επανακλήσεις, μπορείτε να προσαρμόσετε τον τρόπο επεξεργασίας των σελίδων κατά τη μετατροπή.

Μπορώ να ελέγξω το όνομα του αρχείου εξόδου;

Απολύτως! Μπορείτε να καθορίσετε οποιοδήποτε όνομα για το αρχείο εξόδου σας κατά την αποθήκευση του βιβλίου εργασίας.

Πού μπορώ να βρω υποστήριξη για το Aspose.Cells;

Μπορείτε να λάβετε υποστήριξη μεταβαίνοντας στοAspose φόρουμ.