Imposta il carattere predefinito per le opzioni di salvataggio PDF
Introduzione
Quando si tratta di generare report, fatture o altri documenti in formato PDF, assicurarsi che il contenuto abbia un aspetto perfetto è fondamentale. I font svolgono un ruolo fondamentale nel mantenere l’aspetto visivo e la leggibilità dei documenti. Tuttavia, cosa succede quando il font utilizzato nel file Excel non è disponibile sul sistema in cui si genera il PDF? Ecco dove Aspose.Cells per .NET torna utile. Questa potente libreria consente di impostare font predefiniti per le opzioni di salvataggio PDF, assicurando che i documenti abbiano un aspetto professionale e coerente, indipendentemente da dove vengono aperti.
Prerequisiti
Prima di iniziare, assicurati di avere quanto segue:
- Visual Studio: per scrivere ed eseguire il codice avrai bisogno di un ambiente di sviluppo come Visual Studio.
- Aspose.Cells per .NET: puoi scaricare l’ultima versione daquesto collegamentoIn alternativa, puoi installarlo tramite NuGet Package Manager in Visual Studio.
- Conoscenza di base di C#: comprendere le basi di C# ti aiuterà a seguire gli esempi di codice.
- File Excel di esempio: tieni pronto un file Excel di esempio per il test. Puoi crearne uno con vari font e stili per vedere come Aspose.Cells gestisce i font mancanti.
Importa pacchetti
Prima di poter usare Aspose.Cells nel tuo progetto, devi importare i pacchetti necessari. Ecco come fare:
- Apri il tuo progetto: avvia Visual Studio e apri il tuo progetto esistente oppure creane uno nuovo.
- Aggiungere riferimenti: fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e selezionare “Gestisci pacchetti NuGet”.
- Installa Aspose.Cells: cerca “Aspose.Cells” e clicca sul pulsante “Installa”.
- Aggiungi direttive Using: nella parte superiore del file C#, includi i seguenti namespace:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Aspose.Cells.Rendering;
using System.Drawing.Imaging;
Passaggio 1: imposta le tue directory
Prima di lavorare con i file, è importante definire le directory di origine e di output. Ciò renderà più semplice individuare il file Excel di input e salvare i file di output generati.
// Elenco di origine
string sourceDir = "Your Document Directory";
// Directory di uscita
string outputDir = "Your Document Directory";
Sostituire"Your Document Directory"
con il percorso effettivo delle tue directory.
Passaggio 2: aprire il file Excel
Ora che abbiamo impostato le nostre directory, apriamo il file Excel con cui vuoi lavorare. IlWorkbook
La classe in Aspose.Cells viene utilizzata per caricare il documento Excel.
// Aprire un file Excel
Workbook workbook = new Workbook(sourceDir + "sampleSetDefaultFontPropertyOfPdfSaveOptionsAndImageOrPrintOptions.xlsx");
Assicurati di sostituire il nome del file con il nome effettivo del file.
Passaggio 3: impostare le opzioni di rendering delle immagini
Successivamente, dobbiamo configurare le opzioni di rendering per convertire il nostro foglio Excel in un formato immagine. Creeremo un’istanza diImageOrPrintOptions
, specificando il tipo di immagine e il font predefinito.
// Rendering in formato file PNG
ImageOrPrintOptions imgOpt = new ImageOrPrintOptions();
imgOpt.ImageType = Drawing.ImageType.Png;
imgOpt.CheckWorkbookDefaultFont = false;
imgOpt.DefaultFont = "Times New Roman";
In questo frammento di codice, impostiamo ilCheckWorkbookDefaultFont
proprietà afalse
, il che significa che se manca un font, verrà utilizzato il font predefinito specificato (“Times New Roman”).
Passaggio 4: rendere il foglio come immagine
Ora, rendiamo il primo foglio della cartella di lavoro come un’immagine PNG. Useremo ilSheetRender
classe per raggiungere questo obiettivo.
// Rendi il primo foglio di lavoro un'immagine
SheetRender sr = new SheetRender(workbook.Worksheets[0], imgOpt);
sr.ToImage(0, outputDir + "out1_imagePNG.png");
Passaggio 5: modifica il tipo di immagine e il rendering in TIFF
Se vuoi rendere lo stesso foglio in un formato immagine diverso, come TIFF, puoi semplicemente cambiare ilImageType
proprietà e ripetere il processo di rendering.
// Impostato sul formato TIFF
imgOpt.ImageType = Drawing.ImageType.Tiff;
WorkbookRender wr = new WorkbookRender(workbook, imgOpt);
wr.ToImage(outputDir + "out1_imageTIFF.tiff");
Passaggio 6: Configurare le opzioni di salvataggio PDF
Ora, impostiamo le opzioni di salvataggio PDF. Creeremo un’istanza diPdfSaveOptions
imposta il font predefinito e specifica che vogliamo controllare i font mancanti.
// Configurare le opzioni di salvataggio PDF
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.DefaultFont = "Times New Roman";
saveOptions.CheckWorkbookDefaultFont = false;
Passaggio 7: salvare la cartella di lavoro come PDF
Una volta configurate le opzioni di salvataggio, è il momento di salvare la nostra cartella di lavoro Excel come file PDF.
// Salva la cartella di lavoro in PDF
workbook.Save(outputDir + "out1_pdf.pdf", saveOptions);
Passaggio 8: conferma dell’esecuzione
Infine, è una buona norma far sapere all’utente che il processo è stato completato con successo. Puoi farlo utilizzando un semplice messaggio della console.
Console.WriteLine("SetDefaultFontPropertyOfPdfSaveOptionsAndImageOrPrintOptions executed successfully.\r\n");
Conclusione
Aspose.Cells fornisce un modo flessibile e robusto per gestire le manipolazioni dei file Excel, rendendo più facile per gli sviluppatori creare documenti visivamente accattivanti che mantengano la loro formattazione. Che tu stia lavorando su report, documenti finanziari o qualsiasi altra forma di presentazione di dati, avere il controllo sul rendering dei font può migliorare significativamente la qualità dell’output.
Domande frequenti
Che cos’è Aspose.Cells?
Aspose.Cells è una potente libreria .NET che consente agli sviluppatori di manipolare file Excel senza dover installare Microsoft Excel. Supporta vari formati di file e offre funzionalità avanzate per lavorare con i fogli di calcolo.
Come posso impostare un font predefinito per i miei file Excel?
È possibile impostare un font predefinito utilizzandoPdfSaveOptions
class e specifica il nome del font desiderato. Questo assicura che anche se un font è mancante, il tuo documento utilizzerà il font predefinito che hai specificato.
Posso convertire i file Excel in formati diversi dal PDF?
Assolutamente! Aspose.Cells consente di convertire i file Excel in vari formati, tra cui immagini (PNG, TIFF), HTML, CSV e altro ancora.
Aspose.Cells è gratuito?
Aspose.Cells è un prodotto commerciale, ma puoi provarlo gratuitamente con una versione di prova limitata. Per la piena funzionalità, dovrai acquistare una licenza.
Dove posso trovare supporto per Aspose.Cells?
Puoi trovare supporto per Aspose.Cells visitando ilForum di Aspose, dove puoi porre domande e condividere idee con altri utenti e sviluppatori.