C#怎么导出PDF文档？C#使用iTextSharp生成PDF文件的方法有哪些

在C#项目开发中，经常需要将业务数据、报表内容导出为PDF格式供用户下载或存档，iTextSharp是一款功能强大的PDF处理开源类库，支持创建、编辑、导出PDF文件，能够满足大部分常规PDF生成需求。

iTextSharp环境准备

首先需要在项目中引入iTextSharp类库，最便捷的方式是通过NuGet包管理器安装，在Visual Studio的包管理器控制台执行以下命令即可完成安装：

// 安装iTextSharp的NuGet命令
Install-Package iTextSharp

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

using iTextSharp.text;
using iTextSharp.text.pdf;
using System.IO;

基础PDF文件生成步骤

使用iTextSharp生成PDF文件的核心流程分为四步：创建文档对象、设置输出路径、打开文档、添加内容并关闭文档。以下是生成空白PDF的基础代码示例：

public void CreateBasicPdf()
{
    // 定义PDF输出路径
    string filePath = @"D:test.pdf";
    // 创建文档对象，设置页面大小为A4
    Document document = new Document(PageSize.A4);
    try
    {
        // 创建PDF写入器，绑定文档和输出流
        PdfWriter.GetInstance(document, new FileStream(filePath, FileMode.Create));
        // 打开文档
        document.Open();
        // 添加一段基础文本
        document.Add(new Paragraph("这是第一个使用iTextSharp生成的PDF文件"));
    }
    catch (Exception ex)
    {
        // 异常处理逻辑
        throw ex;
    }
    finally
    {
        // 关闭文档，释放资源
        if (document != null)
        {
            document.Close();
        }
    }
}

添加丰富内容到PDF

添加格式化文本

iTextSharp支持设置文本的字体、颜色、大小等样式，需要先加载字体文件，再创建对应的字体对象：

public void AddStyledTextToPdf()
{
    string filePath = @"D:styled_test.pdf";
    Document document = new Document(PageSize.A4);
    PdfWriter.GetInstance(document, new FileStream(filePath, FileMode.Create));
    document.Open();
    // 加载系统字体，这里使用微软雅黑
    string fontPath = Environment.GetFolderPath(Environment.SpecialFolder.Fonts) + @"msyh.ttc,0";
    BaseFont baseFont = BaseFont.CreateFont(fontPath, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
    // 创建12号黑色常规字体
    Font normalFont = new Font(baseFont, 12, Font.NORMAL, BaseColor.BLACK);
    // 创建16号蓝色加粗字体
    Font titleFont = new Font(baseFont, 16, Font.BOLD, BaseColor.BLUE);
    // 添加标题
    document.Add(new Paragraph("PDF内容标题", titleFont));
    // 添加换行
    document.Add(new Paragraph("n"));
    // 添加正文内容
    document.Add(new Paragraph("这是一段设置了样式的正文文本，字体为微软雅黑，大小为12号，颜色为黑色。", normalFont));
    document.Close();
}

添加表格内容

生成报表类PDF时经常需要添加表格，iTextSharp的PdfPTable类可以实现表格创建：

public void AddTableToPdf()
{
    string filePath = @"D:table_test.pdf";
    Document document = new Document(PageSize.A4);
    PdfWriter.GetInstance(document, new FileStream(filePath, FileMode.Create));
    document.Open();
    // 创建3列的表格
    PdfPTable table = new PdfPTable(3);
    // 设置表格宽度为页面宽度的80%
    table.WidthPercentage = 80;
    // 加载字体
    string fontPath = Environment.GetFolderPath(Environment.SpecialFolder.Fonts) + @"msyh.ttc,0";
    BaseFont baseFont = BaseFont.CreateFont(fontPath, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
    Font cellFont = new Font(baseFont, 10, Font.NORMAL, BaseColor.BLACK);
    // 添加表头
    table.AddCell(new PdfPCell(new Phrase("姓名", cellFont)));
    table.AddCell(new PdfPCell(new Phrase("年龄", cellFont)));
    table.AddCell(new PdfPCell(new Phrase("职业", cellFont)));
    // 添加表格数据行
    table.AddCell(new PdfPCell(new Phrase("张三", cellFont)));
    table.AddCell(new PdfPCell(new Phrase("25", cellFont)));
    table.AddCell(new PdfPCell(new Phrase("程序员", cellFont)));
    table.AddCell(new PdfPCell(new Phrase("李四", cellFont)));
    table.AddCell(new PdfPCell(new Phrase("30", cellFont)));
    table.AddCell(new PdfPCell(new Phrase("设计师", cellFont)));
    // 将表格添加到文档
    document.Add(table);
    document.Close();
}

常见问题说明

• 中文显示问题：如果没有正确加载支持中文的字体，中文内容会显示为空白，需要按照示例中的方式加载系统自带的中文字体或者自定义字体文件。
• 路径权限问题：如果指定的PDF输出路径没有写入权限，会抛出IO异常，需要确保输出目录存在且有对应操作权限。
• 资源释放问题：生成PDF后一定要关闭Document对象，否则会导致生成的PDF文件损坏或者无法打开。

注意：iTextSharp的AGPL版本如果用于商业项目需要购买商业授权，开发前需要确认项目的授权合规要求。

C#iTextSharpPDF导出PDF生成修改时间：2026-07-16 01:51:26