C#实现PDF文档自动化生成的开发实战_Asp.net

在现代软件应用中，pdf文档因其跨平台、内容固定性强以及易于分享的特性，扮演着不可或缺的角色。从生成报告、发票到电子合同，程序化地创建和管理pdf文档已成为许多c#开发者的日常需求。但是，如何高效、灵活地使用c#编程语言，将动态数据转化为高质量的pdf文档，同时实现复杂的内容布局（如文本、图片、形状和表格）呢？

本文将深入探讨如何利用c#强大的能力，结合一款功能丰富的pdf处理库，实现pdf文档的自动化生成。我们将从基础环境搭建开始，逐步讲解文本、图片、形状的插入与布局，并着重阐述如何构建结构化的表格，帮助你全面掌握c#生成pdf的核心技能。

pdf文档生成基础与环境准备

在众多应用场景中，如数据可视化、自动化报告系统、在线票据服务等，c#程序化生成pdf的需求日益增长。相比手动创建，编程方式不仅提高了效率，还能确保内容的一致性和准确性。

本教程将基于一款功能强大的pdf处理库进行讲解。该库提供了丰富的api，使得开发者能够轻松地在c#应用程序中创建、编辑、转换和打印pdf文档。

环境配置与库引入：

首先，你需要一个开发环境，如visual studio。然后，通过nuget包管理器将该pdf处理库引入到你的c#项目中。

打开visual studio，创建或打开一个c#项目（例如，一个控制台应用）。
右键点击项目，选择“管理nuget程序包”。
在“浏览”标签页中，搜索并安装该pdf处理库。安装完成后，库的引用将自动添加到你的项目中。

“hello world”式pdf生成示例：

让我们从一个最简单的例子开始，生成一个包含“hello world”文本的pdf文档。

using spire.pdf;
using spire.pdf.graphics;
using system.drawing;

namespace pdfgenerationtutorial
{
    class program
    {
        static void main(string[] args)
        {
            // 创建一个pdf文档实例
            pdfdocument doc = new pdfdocument();

            // 添加一个页面到文档中
            pdfpagebase page = doc.pages.add();

            // 定义字体和画笔
            pdffont font = new pdffont(pdffontfamily.helvetica, 12f);
            pdfbrush brush = pdfbrushes.black;

            // 在页面上绘制文本
            page.canvas.drawstring("hello world from c# pdf!", font, brush, 10, 50);

            // 保存pdf文档
            doc.savetofile("helloworld.pdf");
            doc.dispose();
        }
    }
}

生成结果预览：

这段代码首先创建了一个pdfdocument对象，然后添加一个页面，接着定义了字体和颜色，最后在页面的指定位置绘制了一段文本，并将文档保存为helloworld.pdf。运行此代码，你将看到一个包含“hello world”的pdf文件被创建并打开。

精细化内容布局——文本与图片

pdf文档的内容多样性是其强大之处。接下来，我们将学习如何精细控制文本的样式和布局，以及如何在文档中插入图片。

文本插入与排版

在pdf中插入文本远不止简单地写几个字。我们需要控制字体、字号、颜色、对齐方式，以及处理长文本的自动换行和段落排版。

using spire.pdf;
using spire.pdf.graphics;
using system.drawing;

namespace pdfgenerationtutorial
{
    class addtext
    {
        static void main(string[] args)
        {
            pdfdocument doc = new pdfdocument();
            pdfpagebase page = doc.pages.add();

            // 1. 基本文本绘制
            // 定义不同字体、字号和颜色的文本
            pdftruetypefont font1 = new pdftruetypefont(new font("微软雅黑", 12f), true);
            pdfbrush brush1 = pdfbrushes.darkblue;
            page.canvas.drawstring("这是标题文本", font1, brush1, 50, 50);

            // 2. 段落文本与自动换行
            string longtext = "这是一段较长的示例文本，用于演示如何处理文本的自动换行和段落布局。在实际应用中，你可能需要从数据库或其他数据源获取动态内容，并将其格式化为pdf文档。该库提供了强大的文本布局功能，可以自动处理文本溢出和分页问题，确保内容的完整呈现。";
            pdftruetypefont font2 = new pdftruetypefont(new font("宋体", 12f), true);
            pdfbrush brush2 = pdfbrushes.black;

            // 定义文本布局区域
            rectanglef textbounds = new rectanglef(50, 100, page.canvas.clientsize.width - 100, page.canvas.clientsize.height - 150);

            // 定义文本格式，包括对齐方式和行间距
            pdfstringformat format = new pdfstringformat();
            format.alignment = pdftextalignment.justify; // 两端对齐
            format.linespacing = 15f; // 行间距

            // 绘制文本，库会自动处理换行和分页
            page.canvas.drawstring(longtext, font2, brush2, textbounds, format);

            doc.savetofile("textlayout.pdf");
            doc.dispose();
        }
    }
}

生成结果预览：

上述代码展示了如何绘制不同样式的文本，以及如何通过rectanglef和pdfstringformat控制长文本的布局，包括自动换行、对齐方式和行间距。

图片插入与定位

在pdf中插入图片是增强视觉效果的关键。我们可以控制图片的位置、大小，甚至设置透明度。

using spire.pdf;
using spire.pdf.graphics;
using system.drawing;

namespace pdfgenerationtutorial
{
    class addimage
    {
        static void main(string[] args)
        {
            // 创建pdf文档
            pdfdocument doc = new pdfdocument();
            pdfpagebase page = doc.pages.add();

            // 从文件加载图片
            image image = image.fromfile("logo.png"); // 确保项目根目录有logo.png
            pdfimage pdfimage = pdfimage.fromimage(image);

            // 1. 插入图片到指定位置，使用原始尺寸
            page.canvas.drawimage(pdfimage, 50, 50);

            // 2. 插入图片并调整大小
            // 定义图片目标区域
            rectanglef imagebounds = new rectanglef(50, 250, 200, 150); // x, y, width, height
            page.canvas.drawimage(pdfimage, imagebounds);

            // 3. 插入图片并设置透明度 (作为水印示例)
            // 获取页面尺寸，将水印放置在页面中央
            float pagewidth = page.canvas.clientsize.width;
            float pageheight = page.canvas.clientsize.height;

            // 计算水印图片居中位置
            float watermarkwidth = pdfimage.width * 0.5f; // 缩小50%
            float watermarkheight = pdfimage.height * 0.5f;
            float x = (pagewidth - watermarkwidth) / 2;
            float y = (pageheight - watermarkheight) / 2;

            page.canvas.save(); // 保存当前canvas状态
            page.canvas.settransparency(0.3f, 0.3f, pdfblendmode.multiply); // 设置透明度
            page.canvas.drawimage(pdfimage, x, y, watermarkwidth, watermarkheight); // 绘制水印
            page.canvas.restore(); // 恢复canvas状态

            doc.savetofile("imageinsertion.pdf");
            doc.dispose();
        }
    }
}

生成结果预览：

上述代码展示了如何加载图片并将其插入到pdf的不同位置，包括按原始尺寸插入、调整大小插入，以及通过设置透明度实现水印效果。

增强视觉表现——形状与表格

除了文本和图片，pdf文档还支持绘制各种几何形状和复杂的表格，这对于突出重点信息和组织数据至关重要。

形状绘制

在pdf中绘制基本几何形状（如矩形、圆形、线条）可以帮助我们创建视觉分隔、高亮区域或自定义图表。

using spire.pdf;
using spire.pdf.graphics;
using system.drawing;

namespace pdfgenerationtutorial
{
    class shapesandtables
    {
        static void main(string[] args)
        {
            pdfdocument doc = new pdfdocument();
            pdfpagebase page = doc.pages.add();

            // 1. 绘制线条
            pdfpen pen1 = new pdfpen(pdfbrushes.red, 2f); // 红色，2磅粗
            page.canvas.drawline(pen1, 50, 50, 200, 50); // 水平线
            page.canvas.drawline(pen1, 250, 50, 250, 150); // 垂直线

            // 2. 绘制矩形
            pdfpen pen2 = new pdfpen(color.blue, 1f);
            pdfbrush brush2 = new pdfsolidbrush(color.lightgray);
            page.canvas.drawrectangle(pen2, brush2, 50, 100, 150, 80); // 绘制带边框和填充的矩形

            // 3. 绘制椭圆/圆形
            pdfpen pen3 = new pdfpen(color.green, 3f);
            pdfbrush brush3 = new pdfsolidbrush(color.lightcyan);
            page.canvas.drawellipse(pen3, brush3, 250, 180, 100, 50); // 绘制椭圆
            page.canvas.drawellipse(pen3, brush3, 380, 180, 50, 50); // 绘制圆形

            // 4. 绘制多边形
            pointf[] points = { new pointf(50, 250), new pointf(100, 300), new pointf(150, 250), new pointf(100, 200) };
            pdfpen pen4 = new pdfpen(color.purple, 2f);
            pdfbrush brush4 = new pdfsolidbrush(color.lavender);
            page.canvas.drawpolygon(pen4, brush4, points);

            doc.savetofile("shapes.pdf");
            doc.close();
        }
    }
}

生成结果预览：

这段代码演示了如何使用不同的画笔和画刷绘制线条、矩形、椭圆和多边形，为pdf文档增添视觉元素。

表格创建

表格是展示结构化数据的最佳方式。该库提供了强大的表格组件，支持复杂的表格布局，包括表头、数据行、单元格合并、边框样式、行高列宽调整以及自动分页。

using spire.pdf;
using spire.pdf.graphics;
using spire.pdf.tables;
using system.data;
using system.drawing;

namespace pdfgenerationtutorial
{
    class shapesandtables
    {
        static void main(string[] args)
        {
            pdfdocument doc = new pdfdocument();
            pdfpagebase page = doc.pages.add();

            // 准备数据
            datatable dt = new datatable();
            dt.columns.add("产品id");
            dt.columns.add("产品名称");
            dt.columns.add("单价");
            dt.columns.add("数量");
            dt.columns.add("总计");

            for (int i = 0; i < 20; i++) // 模拟多行数据以演示分页
            {
                dt.rows.add(i + 1, $"产品名称 {i + 1}", (10.00 + i * 0.5).tostring("c2"), i + 1, (10.00 + i * 0.5) * (i + 1));
            }

            // 创建pdftable实例
            pdftable table = new pdftable();
            table.datasource = dt; // 绑定数据源

            // 设置表格样式
            table.style.borderpen = new pdfpen(pdfbrushes.black, 0.5f); // 表格边框
            table.style.defaultstyle.font = new pdftruetypefont(new font("微软雅黑", 10f), true); // 默认字体
            table.style.defaultstyle.stringformat = new pdfstringformat(pdftextalignment.center, pdfverticalalignment.middle);

            // 表头样式
            table.style.headersource = pdfheadersource.rows;
            table.style.headerrowcount = 1;
            table.style.showheader = true;
            table.style.headerstyle.backgroundbrush = new pdfsolidbrush(color.lightsteelblue);
            table.style.headerstyle.font = new pdftruetypefont(new font("微软雅黑", 12f, fontstyle.bold), true);;
            table.style.headerstyle.stringformat = new pdfstringformat(pdftextalignment.center, pdfverticalalignment.middle);
            table.style.repeatheader = true; // 跨页重复表头

            // 隔行样式
            table.style.alternatestyle = new pdfcellstyle();
            table.style.alternatestyle.backgroundbrush = new pdfsolidbrush(color.aliceblue);
            table.style.alternatestyle.font = new pdftruetypefont(new font("微软雅黑", 10f), true);
            table.style.alternatestyle.stringformat = new pdfstringformat(pdftextalignment.center, pdfverticalalignment.middle);

            // 列宽设置
            table.columns[0].width = 60;
            table.columns[1].width = 150;
            table.columns[2].width = 80;
            table.columns[3].width = 60;
            table.columns[4].width = 80;

            // 绘制表格到页面
            table.draw(page, new pointf(50, 50));

            doc.savetofile("complextable.pdf");
            doc.close();
        }
    }
}

生成结果预览：