Monitoraggio dell'avanzamento della conversione dei documenti a livello di programmazione in .NET

Introduzione

Stai cercando di migliorare il tuo processo di conversione dei documenti usando Aspose.Cells per .NET? Se è così, sei nel posto giusto! In questo tutorial, ci immergeremo nel monitoraggio del progresso della conversione dei documenti Excel mentre vengono trasformati in formato PDF. Non solo ti guideremo attraverso i passaggi essenziali per raggiungere questo obiettivo, ma ti forniremo anche alcuni spunti utili lungo il percorso. Quindi, iniziamo!

Prerequisiti

Prima di addentrarci nel dettaglio del monitoraggio della conversione dei documenti, ecco alcuni prerequisiti che dovresti avere:

  1. Conoscenza di base di C#: poiché utilizzeremo C# per scrivere codice, una conoscenza di base di questo linguaggio di programmazione tornerà utile.
  2. Visual Studio installato: questo servirà come ambiente di sviluppo. Puoi usare qualsiasi versione tu preferisca, ma l’ultima è sempre una buona scelta.
  3. Aspose.Cells per .NET: assicurati di avere Aspose.Cells installato. Puoi scaricarlo daSito web di Aspose.
  4. Un file Excel: avere un file Excel di esempio pronto per la conversione. È possibile creare un semplice.xlsx file da seguire.

Importa pacchetti

Ora che abbiamo coperto i nostri prerequisiti, è il momento di importare i pacchetti necessari nel tuo progetto C#. Ecco come fare:

Crea un nuovo progetto

  1. Apri Visual Studio e crea un nuovo progetto. Scegli un modello Console App per semplicità.

Aggiungi riferimento a Aspose.Cells

  1. Fai clic con il pulsante destro del mouse sui Riferimenti in Esplora soluzioni, seleziona Aggiungi riferimento e vai all’assembly Aspose.Cells se non è stato aggiunto automaticamente. Puoi anche usare NuGet Package Manager eseguendo il seguente comando nella Package Manager Console:
Install-Package Aspose.Cells

Importazione degli spazi dei nomi

  1. In cima al tuoProgram.cs file, aggiungere la seguente direttiva using:
using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Ora siamo pronti con la configurazione del nostro progetto!

Dopo aver posto le basi, scomponiamo il processo effettivo di monitoraggio della conversione dei documenti in passaggi di facile comprensione.

Passaggio 1: definisci le tue directory

Inizia specificando le directory in cui risiederanno i tuoi file sorgente e di output. Ecco come fare:

// Elenco di origine
string sourceDir = "Your Document Directory";
// Directory di uscita
string outputDir = "Your Document Directory";

Assicurati di sostituire"Your Document Directory" con il percorso effettivo sul tuo sistema. Questo ti aiuterà a localizzare facilmente i tuoi file.

Passaggio 2: caricare la cartella di lavoro

Successivamente, è necessario caricare la cartella di lavoro di Excel utilizzandoWorkbook classe. Ecco come:

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

Questa riga di codice crea unWorkbook oggetto che ci consentirà di interagire con il file Excel da noi specificato.

Passaggio 3: imposta le opzioni di salvataggio PDF

Ora, impostiamo le opzioni di salvataggio PDF. È qui che inizia la magia del monitoraggio dei progressi. Creerai un’istanza diPdfSaveOptions e assegnargli un callback.

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

Assegnando un callback personalizzato (TestPageSavingCallback), possiamo implementare la nostra logica per monitorare l’avanzamento della conversione delle pagine.

Passaggio 4: salvare la cartella di lavoro in formato PDF

Con tutto impostato, è il momento di salvare la cartella di lavoro come PDF. Utilizzare ilSave metodo delWorkbook classe in questo modo:

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

Questa riga attiverà il processo di conversione e richiamerà i nostri metodi di callback durante l’elaborazione delle pagine.

Passaggio 5: implementare la classe di callback

Ora creiamo ilTestPageSavingCallback classe. Qui è dove si definisce cosa accade all’inizio e alla fine del salvataggio di ogni pagina.

public class TestPageSavingCallback : IPageSavingCallback
{
    public void PageStartSaving(PageStartSavingArgs args)
    {
        Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Non stampare le pagine prima dell'indice di pagina 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);
        // Non stampare le pagine dopo l'indice di pagina 8.
        if (args.PageIndex >= 8)
        {
            args.HasMorePages = false;
        }
    }
}
  • PageStartSavingQuesto metodo viene chiamato appena prima che una pagina inizi a salvare. Qui, registriamo l’inizio del processo di salvataggio per ogni pagina. Inoltre, possiamo controllare se visualizzare la pagina o meno. In questo caso, le pagine prima dell’indice 2 vengono saltate.
  • PageEndSaving: Questo metodo viene invocato dopo che una pagina è stata salvata. Consente di registrare quando termina il salvataggio per ogni pagina e di controllare se devono essere elaborate altre pagine. In questo esempio, ci fermiamo dopo l’indice di pagina 8.

Conclusione

Congratulazioni! Hai implementato con successo un sistema per tracciare l’avanzamento della conversione dei documenti utilizzando Aspose.Cells per .NET. Questo approccio non solo ti consente di monitorare il processo di conversione, ma ti dà anche il controllo su quali pagine includere o escludere, rendendo la gestione dei tuoi documenti molto più efficiente.

Domande frequenti

Che cos’è Aspose.Cells?

Aspose.Cells è una potente libreria .NET che consente agli sviluppatori di creare, manipolare e convertire file Excel a livello di programmazione.

Come posso ottenere una prova gratuita di Aspose.Cells?

Puoi scaricare una versione di prova gratuita daSito web di Aspose.

È possibile personalizzare il processo di conversione?

Sì, utilizzando i callback puoi personalizzare il modo in cui le pagine vengono elaborate durante la conversione.

Posso controllare il nome del file di output?

Assolutamente! Puoi specificare qualsiasi nome per il tuo file di output quando salvi la cartella di lavoro.

Dove posso trovare supporto per Aspose.Cells?

Puoi ottenere supporto visitando ilForum di Aspose.

Salvataggio della cartella di lavoro nel formato di foglio di calcolo Open XML rigoroso in .NET Monitoraggio dell'avanzamento della conversione dei documenti per TIFF a livello di programmazione in .NET