設定 PDF 儲存選項的預設字體
介紹
在產生 PDF 格式的報告、發票或任何其他文件時,請確保內容看起來正確至關重要。字體在保持文件的視覺吸引力和可讀性方面發揮著至關重要的作用。但是,如果您在 Excel 檔案中使用的字體在產生 PDF 的系統上不可用,會發生什麼情況?這就是 Aspose.Cells for .NET 派上用場的地方。這個功能強大的庫可讓您為 PDF 儲存選項設定預設字體,確保您的文件無論在何處打開,都看起來專業且一致。
先決條件
在我們開始之前,請確保您具備以下條件:
- Visual Studio:您需要像 Visual Studio 這樣的開發環境來撰寫和執行程式碼。
- Aspose.Cells for .NET:您可以從以下位置下載最新版本這個連結。或者,您可以透過 Visual Studio 中的 NuGet 套件管理器來安裝它。
- C# 基礎知識:了解 C# 基礎知識將幫助您理解程式碼範例。
- 範例 Excel 檔案:準備一個範例 Excel 檔案以供測試。您可以建立一個具有各種字體和樣式的字體,以查看 Aspose.Cells 如何處理缺少的字體。
導入包
在專案中使用 Aspose.Cells 之前,您需要匯入必要的套件。操作方法如下:
- 開啟您的專案:啟動 Visual Studio 並開啟現有專案或建立新專案。
- 新增參考:在解決方案資源管理器中以滑鼠右鍵按一下您的項目,然後選擇「管理 NuGet 套件」。
- 安裝Aspose.Cells:搜尋「Aspose.Cells」並點選「安裝」按鈕。
- 新增使用指令:在 C# 檔案的頂部,包含以下命名空間:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Aspose.Cells.Rendering;
using System.Drawing.Imaging;
第 1 步:設定您的目錄
在使用檔案之前,定義來源目錄和輸出目錄很重要。這將使您更容易找到輸入的 Excel 檔案並保存產生的輸出檔案。
//原始碼目錄
string sourceDir = "Your Document Directory";
//輸出目錄
string outputDir = "Your Document Directory";
代替"Your Document Directory"
與目錄的實際路徑。
步驟 2: 開啟 Excel 文件
現在我們已經設定了目錄,讓我們打開您要使用的 Excel 檔案。這Workbook
Aspose.Cells 中的類別用於載入 Excel 文件。
//開啟 Excel 文件
Workbook workbook = new Workbook(sourceDir + "sampleSetDefaultFontPropertyOfPdfSaveOptionsAndImageOrPrintOptions.xlsx");
確保將檔案名稱替換為您的實際檔案名稱。
第 3 步:設定影像渲染選項
接下來,我們需要配置渲染選項以將 Excel 工作表轉換為影像格式。我們將建立一個實例ImageOrPrintOptions
,指定圖像類型和預設字體。
//渲染為 PNG 檔案格式
ImageOrPrintOptions imgOpt = new ImageOrPrintOptions();
imgOpt.ImageType = Drawing.ImageType.Png;
imgOpt.CheckWorkbookDefaultFont = false;
imgOpt.DefaultFont = "Times New Roman";
在此程式碼片段中,我們設定CheckWorkbookDefaultFont
財產給false
,這意味著如果缺少任何字體,將使用指定的預設字體(“Times New Roman”)來代替。
步驟 4:將工作表渲染為影像
現在,讓我們將工作簿的第一個工作表渲染為 PNG 映像。我們將使用SheetRender
類別來完成這個任務。
//將第一個工作表渲染為圖像
SheetRender sr = new SheetRender(workbook.Worksheets[0], imgOpt);
sr.ToImage(0, outputDir + "out1_imagePNG.png");
第 5 步:更改影像類型並渲染為 TIFF
如果您想將同一張紙渲染為不同的圖像格式(例如 TIFF),您只需更改ImageType
屬性並重複渲染過程。
//設定為 TIFF 格式
imgOpt.ImageType = Drawing.ImageType.Tiff;
WorkbookRender wr = new WorkbookRender(workbook, imgOpt);
wr.ToImage(outputDir + "out1_imageTIFF.tiff");
步驟 6:設定 PDF 儲存選項
接下來,讓我們設定 PDF 儲存選項。我們將建立一個實例PdfSaveOptions
,設定預設字體,並指定我們要檢查遺失的字體。
//配置 PDF 儲存選項
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.DefaultFont = "Times New Roman";
saveOptions.CheckWorkbookDefaultFont = false;
步驟 7:將工作簿另存為 PDF
配置儲存選項後,就可以將 Excel 工作簿儲存為 PDF 檔案了。
//將工作簿儲存為 PDF
workbook.Save(outputDir + "out1_pdf.pdf", saveOptions);
第8步:確認執行
最後,讓使用者知道該過程已成功完成是一個很好的做法。您可以透過使用簡單的控制台訊息來實現此目的。
Console.WriteLine("SetDefaultFontPropertyOfPdfSaveOptionsAndImageOrPrintOptions executed successfully.\r\n");
結論
Aspose.Cells 提供了一種靈活且強大的方法來處理 Excel 文件操作,使開發人員可以更輕鬆地建立具有視覺吸引力並保持格式的文件。無論您正在處理報告、財務文件或任何其他形式的資料演示,控製字體渲染都可以顯著提高輸出品質。
常見問題解答
什麼是 Aspose.Cells?
Aspose.Cells 是一個功能強大的.NET 程式庫,可讓開發人員操作 Excel 文件,而無需安裝 Microsoft Excel。它支援各種文件格式,並提供豐富的電子表格功能。
如何為 Excel 檔案設定預設字體?
您可以使用以下命令設定預設字體PdfSaveOptions
類別並指定所需的字體名稱。這可以確保即使缺少字體,您的文件也會使用您指定的預設字體。
我可以將 Excel 檔案轉換為 PDF 以外的格式嗎?
絕對地! Aspose.Cells 可讓您將 Excel 檔案轉換為各種格式,包括映像(PNG、TIFF)、HTML、CSV 等。
Aspose.Cells 可以免費使用嗎?
Aspose.Cells 是一個商業產品,但您可以透過有限的試用版免費試用。要獲得完整功能,您需要購買許可證。
在哪裡可以找到對 Aspose.Cells 的支援?
您可以透過造訪找到對 Aspose.Cells 的支持Aspose論壇,您可以在其中提出問題並與其他用戶和開發人員分享見解。