在 Aspose.Cells 中控制 Excel 中的外部资源转换为 PDF
介绍
在当今的数字时代，将 Excel 电子表格转换为 PDF 文档是一项常见任务。无论是准备报告、财务数据还是演示材料，您都希望确保您的 PDF 看起来完全符合您的预期。Aspose.Cells for .NET 是一个强大的库，可让您控制此转换过程直至最后一个细节，尤其是在处理 Excel 文件附带的图像等外部资源时。在本指南中，我们将深入探讨如何使用 Aspose.Cells 在 Excel 到 PDF 的转换过程中控制外部资源。所以，拿上您最喜欢的饮料，让我们开始吧！
先决条件
在开始讨论细节之前，让我们先确保您已准备好一切。以下是一份快速检查清单：
- Visual Studio 或任何与 .NET 兼容的 IDE：您需要一个环境来编写和测试您的代码。
- Aspose.Cells for .NET：如果你还没有安装，请前往Aspose 下载页面并获取最新版本。
- C# 基础知识：熟悉 C# 编程语言会很有帮助。如果您对任何概念不确定，请随时查阅。
- 示例 Excel 文件：准备一个包含您要转换的任何外部资源的 Excel 文件。您可以使用提供的示例文件“samplePdfSaveOptions_StreamProvider.xlsx”。
- 用于测试的图像文件：这将在转换过程中用作外部资源。图像文件“newPdfSaveOptions_StreamProvider.png”是一个很好的占位符。
导入包
首先，您需要从 Aspose.Cells 库导入必要的命名空间。这对于访问其功能至关重要。请确保在文件顶部添加以下使用指令：
using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;
using System;
这些包将提供执行任务所需的所有基本类和方法。
步骤 1：创建流提供程序类
第一项工作是创建一个流提供程序类，该类实现IStreamProvider接口。该类将允许您控制如何加载外部资源。
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-----");
//从内存流中读取新图像并将其赋给 Stream 属性
byte[] bts = File.ReadAllBytes(sourceDir + "newPdfSaveOptions_StreamProvider.png");
MemoryStream ms = new MemoryStream(bts);
options.Stream = ms;
}
}
在本课程中：
- CloseStream：当流关闭时，将调用此方法。目前，我们只是编写一条调试消息进行跟踪。
- InitStream：这是魔法开始的地方。在这里，你将读取外部图像作为字节数组，将其转换为内存流，并将其分配给
options.Stream财产。
第 2 步：设置源和输出目录
现在您的流提供商已经准备就绪，是时候确定您的 Excel 文件的位置以及您想要保存 PDF 的位置了。
//源目录
string sourceDir = "Your Document Directory";
//输出目录
string outputDir = "Your Document Directory";
只需更换"Your Document Directory"与您计算机上文件所在的实际路径。保持文件井然有序是关键！
步骤 3：加载 Excel 文件
接下来，您将加载要从中创建 PDF 的 Excel 文件。
//加载包含外部图像的源 Excel 文件
Workbook wb = new Workbook(sourceDir + "samplePdfSaveOptions_StreamProvider.xlsx");
我们正在使用Workbook来自 Aspose.Cells 的类，代表您的 Excel 文件。该文件可以包含您想要在转换期间控制的各种外部资源，例如图像。
步骤 4：设置 PDF 保存选项
在将工作簿保存为 PDF 之前，让我们指定您想要的保存方式。您可以根据需要调整这些选项。
//指定 PDF 保存选项 - 流提供商
PdfSaveOptions opts = new PdfSaveOptions();
opts.OnePagePerSheet = true; //将每张工作表保存在新页面上
在这里，我们创建一个新的实例PdfSaveOptions，它允许您自定义 PDF 的格式。OnePagePerSheet该选项可方便确保每个 Excel 表在最终的 PDF 中都有自己的页面。
步骤 5：指定您的直播提供商
设置 PDF 选项后，您需要告诉 Aspose 使用您的自定义流提供程序来获取外部资源。
wb.Settings.StreamProvider = new MyStreamProvider();
这条线连接你的Workbook实例MyStreamProvider您之前创建的类。这意味着，无论何时在转换过程中遇到外部资源，您的提供程序都会按照指定的方式处理它们。
步骤 6：将工作簿保存为 PDF
一切设置完毕后，终于可以将 Excel 工作簿保存为 PDF 了。
//将工作簿保存为 Pdf
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);
通过调用Save方法在工作簿对象上并传入输出目录以及 PDF 选项，您就可以将 Excel 文件转换为格式优美的 PDF。
步骤7：确认执行成功
总而言之，确认您的流程已成功总是令人高兴的！
Console.WriteLine("ControlLoadingOfExternalResourcesInExcelToPDF executed successfully.\r\n");
将成功消息打印到控制台有助于让您随时了解操作的状态。将这些小确认信息包含在代码中是一个好习惯。
结论
就是这样！通过遵循这些简单的步骤，您可以熟练地控制在 Excel 到 PDF 转换过程中使用 Aspose.Cells 处理外部资源的方式。这意味着您的文档现在可以准确地包含图像和其他外部元素，确保每次都能获得完美的最终产品。
常见问题解答
什么是 Aspose.Cells？
Aspose.Cells 是一个面向 .NET 开发人员的强大库，可用于创建、操作、转换和呈现各种格式的 Excel 文件。
如何下载 Aspose.Cells？
您可以从下载链接.
我可以免费试用 Aspose.Cells 吗？
是的！您可以访问以下网址获取免费试用免费试用页面.
在哪里可以找到对 Aspose.Cells 的支持？
对于任何与支持相关的疑问，您可以访问Aspose 支持论坛.
如何获得 Aspose.Cells 的临时许可证？
您可以申请临时驾照这里.
