C#教程

关注公众号 jb51net

关闭
首页 > 软件编程 > C#教程 > C# SQL数据导出为PDF

C#使用Free Spire.XLS for .NET实现将SQL数据导出为PDF文件

作者:咕白m625

在企业应用开发中,将数据库查询结果导出为 PDF 格式是常见的报表需求,本文主要介绍了一种基于 Free Spire.XLS for .NET 免费库的实现方式,有需要的小伙伴可以了解下

在企业应用开发中,将数据库查询结果导出为 PDF 格式是常见的报表需求。PDF 具备格式固定、跨平台兼容、便于归档分发等特性,非常适合用于业务数据的正式输出。本文介绍一种基于 Free Spire.XLS for .NET 免费库的实现方式,通过「数据库 → DataTable → Excel 工作表 → PDF」的路径完成数据导出,全程无需依赖 Microsoft Office 环境。

一、实现思路与技术路径

整体实现分为三个核心阶段:

  1. 数据读取:使用 ADO.NET 连接数据库,执行 SQL 查询并将结果集填充到 DataTable 对象中
  2. 数据写入:调用 Free Spire.XLS 的 InsertDataTable 方法,将 DataTable 批量写入 Excel 工作表
  3. 格式转换:通过内置转换引擎将工作表直接输出为 PDF 文件

该方案的优势在于利用 Excel 作为中间载体,可以灵活设置表头样式、列宽、边框等格式,再统一转换为 PDF,相比直接绘制 PDF 表格,开发效率更高。

二、环境准备

2.1 安装依赖包

在 Visual Studio 的 NuGet 包管理器中安装以下两个包:

包管理器控制台安装命令:

Install-Package FreeSpire.XLS
Install-Package Microsoft.Data.SqlClient

2.2 引入命名空间

在代码文件头部引入所需命名空间:

using Spire.Xls;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Drawing;

2.3 版本说明

本文使用的免费版本支持基础的 Excel 编辑与 PDF 转换能力,免费版存在页数限制,PDF 输出仅转换前 3 页内容,适合小规模数据报表场景。

三、完整代码实现

以下示例演示从 SQL Server 数据库读取产品表数据,写入 Excel 并设置基础样式,最终导出为 PDF 文件的完整流程。

3.1 数据库连接与数据查询

/// <summary>
/// 从数据库查询数据并填充到 DataTable
/// </summary>
/// <param name="connectionString">数据库连接字符串</param>
/// <param name="sqlQuery">查询 SQL 语句</param>
/// <returns>填充后的 DataTable</returns>
private static DataTable GetDataFromDatabase(string connectionString, string sqlQuery)
{
    DataTable dataTable = new DataTable();

    using (SqlConnection conn = new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter(sqlQuery, conn);
        try
        {
            adapter.Fill(dataTable);
        }
        catch (Exception ex)
        {
            Console.WriteLine($"数据读取失败:{ex.Message}");
            throw;
        }
    }
    return dataTable;
}

3.2 数据写入 Excel 并导出 PDF

/// <summary>
/// 将 DataTable 数据导出为 PDF 文件
/// </summary>
/// <param name="dataTable">数据源</param>
/// <param name="outputPdfPath">PDF 输出路径</param>
public static void ExportDataTableToPdf(DataTable dataTable, string outputPdfPath)
{
    // 创建工作簿,using 语句自动释放资源
    using (Workbook workbook = new Workbook())
    {
        Worksheet sheet = workbook.Worksheets[0];
        sheet.Name = "数据报表";

        // 将 DataTable 批量写入工作表,参数:数据源、是否显示列名、起始行、起始列
        sheet.InsertDataTable(dataTable, true, 1, 1);

        // 自动获取已填充数据的单元格区域,无需手动计算行列
        CellRange usedRange = sheet.AllocatedRange;

        // 设置表头样式(第一行)
        CellRange headerRange = sheet.Range[1, 1, 1, dataTable.Columns.Count];
        headerRange.Style.Font.IsBold = true;
        headerRange.Style.Font.Size = 11;
        headerRange.Style.Color = Color.LightSkyBlue;
        headerRange.Style.HorizontalAlignment = HorizontalAlignType.Center;
        headerRange.Style.VerticalAlignment = VerticalAlignType.Center;

        // 快速设置全数据区域边框(外边框+内部分隔线)
        usedRange.BorderAround(LineStyleType.Thin);
        usedRange.BorderInside(LineStyleType.Thin);

        // 设置全数据区域居中对齐
        usedRange.Style.HorizontalAlignment = HorizontalAlignType.Center;
        usedRange.Style.VerticalAlignment = VerticalAlignType.Center;

        // 仅对有数据的列执行自适应,提升性能
        usedRange.AutoFitColumns();

        // 页面设置:表格内容在页面中水平居中
        sheet.PageSetup.CenterHorizontally = true;

        // 导出为 PDF 文件
        workbook.SaveToFile(outputPdfPath, FileFormat.PDF);
    }
}

3.3 主程序调用示例

static void Main(string[] args)
{
    // 数据库连接字符串
    string connString = "Server=localhost\\SQLEXPRESS;Database=SalesDB;User ID=demouser;Password=YourPassword;Encrypt=true;TrustServerCertificate=true;";

    // 查询 SQL
    string sql = @"
    SELECT 
        o.OrderID AS 订单编号,
        c.CustomerName AS 客户名称,
        o.OrderDate AS 订单日期,
        o.TotalAmount AS 订单金额
    FROM Orders o
    JOIN Customers c ON o.CustomerID = c.CustomerID
    WHERE YEAR(o.OrderDate) = 2026;
";
  
  
    // PDF 输出路径
    string outputPath = @"D:\Reports\SalesReport_2026.pdf";

    try
    {
        DataTable data = GetDataFromDatabase(connString, sql);
        ExportDataTableToPdf(data, outputPath);
        Console.WriteLine($"PDF 导出成功,文件已保存至:{outputPath}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"导出流程出错:{ex.Message}");
    }

    Console.ReadKey();
}

四、PDF 输出优化建议

4.1 页面方向与尺寸

对于列数较多的宽表,建议设置为横向打印以避免内容被截断:

sheet.PageSetup.Orientation = PageOrientationType.Landscape;
sheet.PageSetup.PaperSize = PaperSizeType.PaperA4;

4.2 缩放适配

开启页面自适应,确保所有列能在一页宽度内显示:

workbook.ConverterSetting.SheetFitToWidth = 1;
workbook.ConverterSetting.SheetFitToPage = false;

以上方案提供了一条清晰的数据库到 PDF 的导出路径,代码结构简单且易于扩展。开发者可在此基础上根据业务需求增加表头合并、条件格式、合计行等高级报表特性。

到此这篇关于C#使用Free Spire.XLS for .NET实现将SQL数据导出为PDF文件的文章就介绍到这了,更多相关C# SQL数据导出为PDF内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:
阅读全文