Controllo delle risorse esterne con Aspose.Cells per .NET

Introduzione

Nel panorama digitale odierno, convertire fogli di calcolo Excel in documenti PDF è un’attività comune ed essenziale. Che tu stia preparando report, dati finanziari o materiali di presentazione, assicurarti che i tuoi PDF riflettano il formato desiderato è fondamentale. Aspose.Cells per .NET fornisce una potente libreria che ti consente di controllare questo processo di conversione in dettaglio, specialmente quando si ha a che fare con risorse esterne come le immagini. In questa guida, esploreremo come gestire efficacemente le risorse esterne durante il processo di conversione da Excel a PDF utilizzando Aspose.Cells. Immergiamoci!

Prerequisiti

Prima di iniziare, assicurati di avere pronto quanto segue:

1. Visual Studio o qualsiasi IDE compatibile con .NET: questo sarà il tuo ambiente di sviluppo.
2. Aspose.Cells per .NET: se non lo hai ancora installato, visita il sitoScarica Aspose pagina per ottenere la versione più recente.
3. Conoscenza di base di C#: la familiarità con C# sarà utile. Se hai bisogno di chiarimenti su qualsiasi concetto, sentiti libero di cercarli.
4. File Excel di esempio: preparare un file Excel, ad esempio “samplePdfSaveOptions_StreamProvider.xlsx”, che contenga le risorse esterne che si desidera convertire.
5. File immagine per il test: utilizzare un file immagine come “newPdfSaveOptions_StreamProvider.png” come risorsa esterna durante la conversione.

Importa i pacchetti necessari

Per iniziare, dovrai importare i namespace richiesti dalla libreria Aspose.Cells. Aggiungi le seguenti direttive using all’inizio del tuo file C#:

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

Questi namespace forniscono le classi e i metodi essenziali per le tue attività.

Passaggio 1: creare una classe di provider di streaming

Per prima cosa, crea una classe provider di streaming che implementi l’IStreamProvider interfaccia. Questa classe ti consentirà di controllare come vengono caricate le risorse esterne.

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-----");
        
        // Carica l'immagine in un flusso di memoria
        byte[] bts = File.ReadAllBytes(Path.Combine(sourceDir, "newPdfSaveOptions_StreamProvider.png"));
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

• CloseStream: questo metodo viene chiamato quando il flusso viene chiuso e registra un messaggio di debug.
• InitStream: questo metodo legge il file immagine esterno come un array di byte, lo converte in un flusso di memoria e lo assegna aloptions.Stream proprietà.

Passaggio 2: impostare le directory di origine e di output

Successivamente, definisci le directory per il file Excel e il PDF di output.

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

Sostituire"Your Document Directory" con il percorso effettivo sul sistema in cui si trovano i tuoi file.

Passaggio 3: carica il file Excel

Ora carica il file Excel da cui vuoi creare il PDF.

// Carica il file Excel di origine contenente immagini esterne
Workbook wb = new Workbook(sourceDir, "samplePdfSaveOptions_StreamProvider.xlsx");

ILWorkbook La classe di Aspose.Cells rappresenta il file Excel, che può includere varie risorse esterne come le immagini.

Passaggio 4: imposta le opzioni di salvataggio PDF

Prima di salvare la cartella di lavoro in formato PDF, specifica le opzioni di salvataggio desiderate.

// Specificare le opzioni di salvataggio PDF - Fornitore di streaming
PdfSaveOptions opts = new PdfSaveOptions
{
    OnePagePerSheet = true // Salva ogni foglio su una nuova pagina
};

Ciò crea un’istanza diPdfSaveOptions , consentendo di personalizzare il formato PDF. IlOnePagePerSheet Questa opzione garantisce che ogni foglio Excel venga visualizzato su una pagina separata nel PDF finale.

Passaggio 5: Assegna il tuo fornitore di streaming

Connetti il tuoWorkbook istanza con ilMyStreamProvider classe creata in precedenza.

wb.Settings.StreamProvider = new MyStreamProvider();

Questa riga garantisce che ogni volta che durante la conversione vengono incontrate risorse esterne, il tuo provider personalizzato le gestirà di conseguenza.

Passaggio 6: salvare la cartella di lavoro in formato PDF

Ora salva la tua cartella di lavoro Excel come PDF.

// Salva la cartella di lavoro in PDF
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

Chiamando ilSave sull’oggetto cartella di lavoro e passando la directory di output insieme alle opzioni PDF, si converte il file Excel in un PDF ben formattato.

Passaggio 7: confermare l’esecuzione corretta

Infine, è buona norma confermare che il processo sia stato completato correttamente.

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

Questo messaggio ti informerà sullo stato della tua operazione, fornendoti un feedback utile.

Conclusione

Ora hai padroneggiato il processo di controllo delle risorse esterne durante le conversioni da Excel a PDF usando Aspose.Cells! Seguendo questi passaggi, puoi assicurarti che i tuoi documenti includano accuratamente immagini e altri elementi esterni, ottenendo ogni volta un prodotto finale rifinito.

Domande frequenti

Che cos’è Aspose.Cells?

Aspose.Cells è una potente libreria per sviluppatori .NET che consente la creazione, la manipolazione, la conversione e il rendering di file Excel in vari formati.

Come posso scaricare Aspose.Cells?

Puoi scaricare l’ultima versione daLink per scaricare.

Posso provare Aspose.Cells gratuitamente?

Sì! Puoi accedere a una prova gratuita visitando ilPagina di prova gratuita.

Dove posso trovare supporto per Aspose.Cells?

Per domande relative al supporto, visitare ilForum di supporto Aspose.

Come posso ottenere una licenza temporanea per Aspose.Cells?

Puoi richiedere una licenza temporaneaQui.