C#高效創(chuàng)建PDF表格的實用技巧

更新時間：2025年11月12日 08:18:05 作者：用戶835629078051

PDF文檔因其跨平臺、內容固定的特性,成為企業(yè)級應用中不可或缺的報告、發(fā)票、合同等輸出格式,下面我們就來深入探討如何利用C#和Spire.PDF for .NET實現在PDF文檔中創(chuàng)建美觀且功能豐富的表格吧

PDF文檔因其跨平臺、內容固定的特性，成為企業(yè)級應用中不可或缺的報告、發(fā)票、合同等輸出格式。對于C#開發(fā)者而言，在處理這些文檔時，將結構化數據以清晰、專業(yè)、美觀的表格形式呈現，是常見的需求。然而，手動計算布局、繪制線條，或使用一些功能不完善的庫來構建表格，往往耗時耗力，效率低下，且難以滿足復雜的定制需求。

本文將深入探討如何利用C#和一款強大的第三方庫——Spire.PDF for .NET，高效、靈活地在PDF文檔中創(chuàng)建美觀且功能豐富的表格。無論你是需要一個簡單的靜態(tài)表格，還是需要一個能動態(tài)填充數據、支持復雜布局的報表，本文都將為你提供全面的解決方案，助你從零開始，掌握在PDF中構建表格的各項技能。

1. 輕松集成：為你的C#項目引入PDF處理庫

在C#項目中處理PDF文檔，通常需要借助第三方庫。Spire.PDF for .NET是E-iceblue公司開發(fā)的一款功能強大、易于使用的PDF組件，它提供了豐富的API，支持PDF的創(chuàng)建、編輯、轉換、打印等多種操作。對于表格創(chuàng)建而言，Spire.PDF提供了直觀的對象模型，極大地簡化了開發(fā)難度。

集成步驟：

在你的C#項目中，通過NuGet包管理器安裝Spire.PDF庫。打開Visual Studio，右鍵點擊項目，選擇“管理NuGet程序包”，搜索“Spire.PDF”，然后點擊安裝。

// 通過NuGet安裝Spire.PDF后，你的項目會自動添加相應的引用。
// 你可以在代碼中通過以下using語句引入必要的命名空間：
using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.Tables;
using System.Drawing;
using System.Data; // 用于動態(tài)數據表格
using System.Collections.Generic; // 用于動態(tài)數據表格

2. 從零開始：使用C#創(chuàng)建PDF中的簡單表格

創(chuàng)建PDF文檔中的表格，首先需要創(chuàng)建一個PDF文檔實例，添加頁面，然后定義表格對象，并設置其基本屬性。

以下是一個創(chuàng)建包含少量靜態(tài)數據的簡單表格的示例：

using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.Tables;
using System.Drawing;

public class SimplePdfTable
{
    public static void Create()
    {
        // 1. 創(chuàng)建Pdf文檔實例
        PdfDocument doc = new PdfDocument();
        // 2. 添加頁面
        PdfPageBase page = doc.Pages.Add();

        // 3. 定義表格數據
        string[] header = { "產品ID", "產品名稱", "單價", "數量" };
        string[][] data =
        {
            new string[] { "P001", "筆記本電腦", "8999.00", "1" },
            new string[] { "P002", "無線鼠標", "129.00", "2" },
            new string[] { "P003", "機械鍵盤", "459.00", "1" }
        };

        // 4. 創(chuàng)建PdfTable對象
        PdfTable table = new PdfTable();
        table.Style.CellPadding = 5; // 設置單元格內邊距
        table.Style.BorderPen = new PdfPen(Color.Black, 0.75f); // 設置邊框樣式

        // 設置表頭樣式
        table.Style.HeaderSource = PdfHeaderSource.Rows;
        table.Style.HeaderRowCount = 1;
        table.Style.ShowHeader = true;
        table.Style.HeaderStyle.BackgroundBrush = PdfBrushes.CadetBlue;
        table.Style.HeaderStyle.Font = new PdfTrueTypeFont(new Font("Arial", 12f, FontStyle.Bold));
        table.Style.HeaderStyle.StringFormat = new PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle);

        // 設置默認單元格樣式
        table.Style.DefaultStyle.Font = new PdfTrueTypeFont(new Font("Arial", 10f));
        table.Style.DefaultStyle.StringFormat = new PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle);

        // 5. 將數據填充到表格
        table.DataSource = data;

        // 6. 設置表格的列寬 (可選，不設置則自動調整)
        table.Columns[0].Width = 80;
        table.Columns[1].Width = 150;
        table.Columns[2].Width = 100;
        table.Columns[3].Width = 80;

        // 7. 繪制表格到頁面
        PdfLayoutResult result = table.Draw(page, new PointF(50, 50)); // 在頁面坐標(50, 50)處繪制表格

        // 8. 保存文檔
        doc.SaveToFile("SimpleTable.pdf");
        doc.Close();
    }
}

代碼解釋：

PdfDocument 和 PdfPageBase：PDF文檔和頁面的基本對象。
PdfTable：表示PDF中的表格。
table.Style.CellPadding：控制單元格內容的內邊距。
table.Style.BorderPen：設置表格及單元格的邊框顏色和粗細。
table.Style.HeaderSource 和 table.Style.HeaderRowCount：指定表格數據的第一行作為表頭。
table.Style.HeaderStyle：設置表頭的背景、字體和文本對齊方式。
table.Style.DefaultStyle：設置表格中普通單元格的默認樣式。
table.DataSource：將二維字符串數組 data 綁定到表格。Spire.PDF會自動根據數據源創(chuàng)建行和列。
table.Columns[index].Width：設置特定列的寬度。
table.Draw(page, new PointF(x, y))：將表格繪制到指定的頁面和坐標。

3. 靈活掌控：實現復雜表格布局與動態(tài)數據填充

在實際應用中，表格往往需要更復雜的樣式定制，例如合并單元格、調整行高列寬，以及從數據庫或數據集合中動態(tài)填充數據。

3.1 自定義單元格樣式與合并單元格

using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.Tables;
using System.Drawing;
using System.Data;

public class AdvancedPdfTable
{
    public static void Create()
    {
        PdfDocument doc = new PdfDocument();
        PdfPageBase page = doc.Pages.Add();

        PdfTable table = new PdfTable();
        table.Style.CellPadding = 5;
        table.Style.BorderPen = new PdfPen(Color.Gray, 0.5f);

        // 定義表頭
        table.Columns.Add(new PdfColumn("ID"));
        table.Columns.Add(new PdfColumn("項目"));
        table.Columns.Add(new PdfColumn("描述"));
        table.Columns.Add(new PdfColumn("狀態(tài)"));

        // 添加數據行
        PdfTableRow row1 = table.Rows.Add();
        row1.Cells[0].Value = "1";
        row1.Cells[1].Value = "任務A";
        row1.Cells[2].Value = "完成需求分析";
        row1.Cells[3].Value = "已完成";

        PdfTableRow row2 = table.Rows.Add();
        row2.Cells[0].Value = "2";
        row2.Cells[1].Value = "任務B";
        row2.Cells[2].Value = "開發(fā)模塊X";
        row2.Cells[3].Value = "進行中";
        // 設置特定單元格背景色和字體
        row2.Cells[3].Style.BackgroundBrush = PdfBrushes.LightYellow;
        row2.Cells[3].Style.Font = new PdfTrueTypeFont(new Font("Arial", 10f, FontStyle.Italic));

        PdfTableRow row3 = table.Rows.Add();
        row3.Cells[0].Value = "3";
        row3.Cells[1].Value = "任務C";
        row3.Cells[2].Value = "測試功能Y";
        row3.Cells[3].Value = "待開始";

        // 合并單元格示例 (合并第4行，第0列和第1列)
        PdfTableRow row4 = table.Rows.Add();
        row4.Cells[0].Value = "總計：";
        row4.Cells[0].ColumnSpan = 2; // 合并當前單元格及其右側一個單元格
        row4.Cells[2].Value = "3個任務";
        row4.Cells[3].Value = ""; // 可以留空或設置其他內容
        row4.Height = 25; // 設置行高
        row4.Cells[0].Style.BackgroundBrush = PdfBrushes.LightGray;
        row4.Cells[0].Style.Font = new PdfTrueTypeFont(new Font("Arial", 11f, FontStyle.Bold));
        row4.Cells[0].Style.StringFormat = new PdfStringFormat(PdfTextAlignment.Right, PdfVerticalAlignment.Middle);


        // 設置表頭樣式
        table.Style.HeaderSource = PdfHeaderSource.Rows;
        table.Style.HeaderRowCount = 1; // 第一行是表頭
        table.Style.HeaderStyle.BackgroundBrush = PdfBrushes.DarkSlateBlue;
        table.Style.HeaderStyle.TextBrush = PdfBrushes.White;
        table.Style.HeaderStyle.Font = new PdfTrueTypeFont(new Font("Arial", 11f, FontStyle.Bold));
        table.Style.HeaderStyle.StringFormat = new PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle);

        PdfLayoutResult result = table.Draw(page, new PointF(50, 50));
        doc.SaveToFile("AdvancedTable.pdf");
        doc.Close();
    }
}

代碼解釋：

通過 table.Columns.Add() 逐個添加列，并指定列名。
通過 table.Rows.Add() 添加行，并通過 row.Cells[index].Value 填充單元格數據。
row.Cells[index].Style：可以針對單個單元格設置獨立的樣式，覆蓋表格的默認樣式。
row.Cells[index].ColumnSpan：實現單元格橫向合并，值為需要合并的列數。
row.Height：設置特定行的高度。

3.2 動態(tài)數據綁定 (以DataTable為例)

在實際業(yè)務中，表格數據通常來源于數據庫查詢或內存中的數據集合。Spire.PDF支持直接綁定 DataTable 或 IEnumerable<T> 類型的數據源。

假設我們有一個 DataTable 存儲了訂單信息：

using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.Tables;
using System.Drawing;
using System.Data;
using System.Collections.Generic;

public class DynamicPdfTable
{
    // 模擬數據源
    private static DataTable GetOrderData()
    {
        DataTable dt = new DataTable("Orders");
        dt.Columns.Add("OrderId", typeof(int));
        dt.Columns.Add("CustomerName", typeof(string));
        dt.Columns.Add("OrderDate", typeof(DateTime));
        dt.Columns.Add("Amount", typeof(decimal));

        dt.Rows.Add(1001, "張三", DateTime.Now.AddDays(-5), 1250.50m);
        dt.Rows.Add(1002, "李四", DateTime.Now.AddDays(-2), 899.00m);
        dt.Rows.Add(1003, "王五", DateTime.Now.AddDays(-1), 2300.75m);
        dt.Rows.Add(1004, "趙六", DateTime.Now, 500.00m);
        return dt;
    }

    public static void Create()
    {
        PdfDocument doc = new PdfDocument();
        PdfPageBase page = doc.Pages.Add();

        PdfTable table = new PdfTable();
        table.Style.CellPadding = 3;
        table.Style.BorderPen = new PdfPen(Color.LightGray, 0.5f);

        // 設置表頭樣式
        table.Style.HeaderSource = PdfHeaderSource.Rows;
        table.Style.HeaderRowCount = 1;
        table.Style.HeaderStyle.BackgroundBrush = PdfBrushes.DarkGreen;
        table.Style.HeaderStyle.TextBrush = PdfBrushes.White;
        table.Style.HeaderStyle.Font = new PdfTrueTypeFont(new Font("Microsoft YaHei", 10f, FontStyle.Bold));
        table.Style.HeaderStyle.StringFormat = new PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle);

        // 設置交替行樣式
        table.Style.AlternateStyle = new PdfCellStyle();
        table.Style.AlternateStyle.BackgroundBrush = PdfBrushes.LightCyan;

        // 綁定DataTable數據源
        table.DataSource = GetOrderData();

        // 調整列寬
        table.Columns[0].Width = 60; // OrderId
        table.Columns[1].Width = 120; // CustomerName
        table.Columns[2].Width = 100; // OrderDate
        table.Columns[3].Width = 80; // Amount

        // 設置特定列的文本對齊方式
        table.Columns[0].StringFormat = new PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle);
        table.Columns[3].StringFormat = new PdfStringFormat(PdfTextAlignment.Right, PdfVerticalAlignment.Middle);

        PdfLayoutResult result = table.Draw(page, new PointF(50, 50));
        doc.SaveToFile("DynamicTable.pdf");
        doc.Close();
    }
}

代碼解釋：

GetOrderData()：模擬從數據庫獲取數據并填充到 DataTable。
table.DataSource = GetOrderData()：直接將 DataTable 實例賦值給 DataSource 屬性。Spire.PDF會自動讀取 DataTable 的列名作為表頭，并填充所有數據行。
table.Style.AlternateStyle：設置交替行的樣式，可以使表格更具可讀性。
table.Columns[index].StringFormat：可以為整列設置統(tǒng)一的文本對齊方式。

4. 精益求精：優(yōu)化表格呈現與文檔保存

表格繪制完成后，我們還需要考慮其在頁面上的位置、可能的跨頁顯示以及最終的文檔保存。

using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.Tables;
using System.Drawing;
using System.Data;

public class OptimizedPdfTable
{
    // ... (GetOrderData 方法同上) ...

    public static void Create()
    {
        PdfDocument doc = new PdfDocument();
        PdfPageBase page = doc.Pages.Add();

        PdfTable table = new PdfTable();
        table.Style.CellPadding = 3;
        table.Style.BorderPen = new PdfPen(Color.LightGray, 0.5f);
        table.Style.HeaderSource = PdfHeaderSource.Rows;
        table.Style.HeaderRowCount = 1;
        table.Style.HeaderStyle.BackgroundBrush = PdfBrushes.DarkGreen;
        table.Style.HeaderStyle.TextBrush = PdfBrushes.White;
        table.Style.HeaderStyle.Font = new PdfTrueTypeFont(new Font("Microsoft YaHei", 10f, FontStyle.Bold));
        table.Style.HeaderStyle.StringFormat = new PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle);
        table.Style.AlternateStyle = new PdfCellStyle();
        table.Style.AlternateStyle.BackgroundBrush = PdfBrushes.LightCyan;

        // 模擬大量數據，以便觀察跨頁效果
        DataTable largeData = GetOrderData();
        for (int i = 0; i < 50; i++) // 增加數據量
        {
            largeData.Rows.Add(1005 + i, "客戶" + (i + 7), DateTime.Now.AddDays(-i), 100.00m + i * 5);
        }
        table.DataSource = largeData;

        // 設置列寬
        table.Columns[0].Width = 60;
        table.Columns[1].Width = 120;
        table.Columns[2].Width = 100;
        table.Columns[3].Width = 80;

        // **重要：處理表格跨頁**
        // Spire.PDF的Draw方法會自動處理表格的跨頁，如果表格內容超出當前頁面，
        // 它會自動在下一頁繼續(xù)繪制，并返回PdfLayoutResult指示繪制結果。
        // 如果需要重復表頭，可以設置 table.Style.RepeatHeader = true;
        table.Style.RepeatHeader = true; // 跨頁時重復表頭

        // 定義表格繪制的區(qū)域和布局方式
        PdfLayoutFormat format = new PdfLayoutFormat();
        format.Break = PdfLayoutBreakType.FitPage; // 盡量在一頁內顯示，超出則分頁
        format.Layout = PdfLayoutType.Paginate;   // 自動分頁

        // 繪制表格到頁面，從指定位置開始
        // 注意：Draw方法會返回一個PdfLayoutResult對象，其中包含表格繪制后的最后一個位置，
        // 方便后續(xù)內容接著表格繪制。
        PdfLayoutResult result = table.Draw(page, new PointF(50, 50), format);

        // 如果表格繪制到了新頁面，result.Page 會是新的頁面對象
        // 可以在這里添加一些頁面底部或新頁面的內容
        // 例如：
        // if (result.Page != page)
        // {
        //     result.Page.Canvas.DrawString("（續(xù)上頁）", new PdfTrueTypeFont(new Font("Arial", 8)), PdfBrushes.Gray, 50, 20);
        // }


        // 保存文檔
        doc.SaveToFile("OptimizedTable.pdf");
        doc.Close();
    }

    private static DataTable GetOrderData()
    {
        DataTable dt = new DataTable("Orders");
        dt.Columns.Add("OrderId", typeof(int));
        dt.Columns.Add("CustomerName", typeof(string));
        dt.Columns.Add("OrderDate", typeof(DateTime));
        dt.Columns.Add("Amount", typeof(decimal));

        dt.Rows.Add(1001, "張三", DateTime.Now.AddDays(-5), 1250.50m);
        dt.Rows.Add(1002, "李四", DateTime.Now.AddDays(-2), 899.00m);
        dt.Rows.Add(1003, "王五", DateTime.Now.AddDays(-1), 2300.75m);
        dt.Rows.Add(1004, "趙六", DateTime.Now, 500.00m);
        return dt;
    }
}

代碼解釋：

table.Style.RepeatHeader = true;：這是處理表格跨頁時非常關鍵的設置，它確保在表格內容延續(xù)到新頁面時，表頭能夠在新頁面的頂部重復顯示，提高了報告的可讀性。
PdfLayoutFormat：這個對象允許你更精細地控制表格的布局行為。
- format.Break = PdfLayoutBreakType.FitPage;：指示Spire.PDF在表格內容超出當前頁面時，在頁面底部自動斷開，并在下一頁繼續(xù)。
- format.Layout = PdfLayoutType.Paginate;：啟用自動分頁功能。
table.Draw(page, new PointF(50, 50), format);：將 PdfLayoutFormat 對象傳遞給 Draw 方法，使表格按照定義的布局規(guī)則進行繪制。PdfLayoutResult 包含了繪制后的信息，例如表格結束的位置和繪制到的最后一頁。