首页 > 软件编程 > C#教程 > C#选定单元格范围转为PDF

在C#中将选定的单元格范围转换为PDF的操作步骤

2025-09-11 08:25:21 作者：缺点内向

在实际开发中,我们经常需要处理Excel文件,并将其转换为PDF格式以方便分享、打印或存档,然而,直接将整个工作表转换为PDF,常常会导致隐私泄露的风险,那么,如何在C#中高效、准确地将Excel的“选定单元格范围”转换为PDF,下面小编给大家详细说说

引言

在实际开发中，我们经常需要处理Excel文件，并将其转换为PDF格式以方便分享、打印或存档。然而，直接将整个工作表转换为PDF，常常会导致——PDF文件臃肿、包含大量不必要信息，甚至可能面临隐私泄露的风险。那么，如何在C#中高效、准确地将Excel的“选定单元格范围”转换为PDF，只导出所需数据呢？本文将为你揭示一个基于专业库的解决方案。

核心利器：Spire.XLS 在 C# 中的应用

Spire.XLS 是一款专业的.NET Excel组件，它允许开发者在C#、VB.NET等语言中快速、高效地创建、读取、编辑、转换和打印Excel文件。

选择 Spire.XLS 的原因在于：

强大的转换能力： 它提供了将Excel转换为PDF、HTML、CSV、图片等多种格式的功能，且转换效果高度还原。
灵活的API： Spire.XLS 提供了丰富的API，可以精细控制Excel的各个元素，包括单元格、行、列、区域、样式等，这为我们精确选择和处理单元格范围提供了可能。
高性能与稳定性： 面对大型Excel文件和复杂的转换任务，Spire.XLS 表现出良好的性能和稳定性。

C# 代码实战：将选定单元格范围转换为 PDF

接下来，我们将通过具体的C#代码示例，手把手教你如何使用 Spire.XLS 实现这一功能。

步骤一：准备工作与环境配置

首先，你需要在你的C#项目中安装 Spire.XLS NuGet 包。

在 Visual Studio 中，右键点击你的项目 -> “管理 NuGet 包”。
搜索 “Spire.XLS”，然后点击“安装”。

安装完成后，在你的代码文件中引入必要的命名空间：

using Spire.Xls;
using Spire.Pdf; // 如果需要更高级的PDF操作，可能也需要

步骤二：加载 Excel 文件与选择范围

我们将通过一个巧妙的方法来实现范围转换：将选定的单元格范围复制到一个新的工作表，然后将这个新工作表保存为PDF。

// 创建一个工作簿实例
Workbook workbook = new Workbook();

// 从磁盘加载现有的 Excel 文件
workbook.LoadFromFile(@"D:\Data\ConversionSample1.xlsx"); // 请替换为你的实际文件路径

// 在工作簿中添加一个新的工作表，用于存放选定范围的数据
Worksheet newSheet = workbook.Worksheets.Add("SelectedRangeSheet");

// 获取原始工作表（这里假设是第一个工作表）
Worksheet originalSheet = workbook.Worksheets[0];

// 定义要转换的单元格范围，例如 "A9:E15"
// 你可以根据实际需求修改这个范围
CellRange selectedRange = originalSheet.Range["A9:E15"];

// 将选定的单元格范围复制到新工作表
// 第一个参数是目标范围的起始位置，第二个参数表示是否复制样式，第三个参数表示是否复制值
selectedRange.Copy(newSheet.Range["A1"], true, true); 

// （可选）自动调整新工作表中列的宽度，以确保内容完整显示
newSheet.AutoFitColumns();

注意： 在 selectedRange.Copy(newSheet.Range["A1"], true, true); 中，我们将源范围复制到新工作表的 A1 开始的位置。这样做的好处是，新生成的PDF将从左上角开始显示数据，避免了原始Excel中可能存在的空白前缀。

步骤三：配置 PDF 导出选项并执行转换

现在，我们已经将所需范围的数据复制到了一个新工作表。接下来，只需将这个新工作表保存为PDF即可。

// 定义输出 PDF 文件的路径
string outputPdfPath = "SelectedRangeToPDF.pdf";

// 将新创建的工作表保存为 PDF 文件
// Spire.XLS 会自动处理分页和布局
newSheet.SaveToPdf(outputPdfPath);

// 提示转换成功
Console.WriteLine($"选定范围已成功转换为 PDF：{outputPdfPath}");

完整代码示例：

using System;
using Spire.Xls; // 引入 Spire.Xls 命名空间

namespace ExcelRangeToPdf
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建一个工作簿实例
            Workbook workbook = new Workbook();

            try
            {
                // 从磁盘加载现有的 Excel 文件
                // 请将 "D:\Data\ConversionSample1.xlsx" 替换为你实际的 Excel 文件路径
                workbook.LoadFromFile(@"D:\Data\ConversionSample1.xlsx");

                // 在工作簿中添加一个新的工作表，用于存放选定范围的数据
                Worksheet newSheet = workbook.Worksheets.Add("SelectedRangeSheet");

                // 获取原始工作表（这里假设是第一个工作表，索引为0）
                Worksheet originalSheet = workbook.Worksheets[0];

                // 定义要转换的单元格范围，例如 "A9:E15"
                // 你可以根据实际需求修改这个范围字符串
                CellRange selectedRange = originalSheet.Range["A9:E15"];

                // 将选定的单元格范围（包括样式和值）复制到新工作表的 A1 位置
                selectedRange.Copy(newSheet.Range["A1"], true, true);

                // （可选）自动调整新工作表中列的宽度，以确保内容完整显示
                newSheet.AutoFitColumns();

                // 定义输出 PDF 文件的路径
                string outputPdfPath = "SelectedRangeToPDF.pdf";

                // 将新创建的工作表保存为 PDF 文件
                newSheet.SaveToPdf(outputPdfPath);

                Console.WriteLine($"选定范围已成功转换为 PDF：{outputPdfPath}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"转换过程中发生错误：{ex.Message}");
            }
            finally
            {
                // 释放资源
                workbook.Dispose();
            }
        }
    }
}