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

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

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

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

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

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

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

集成步驟：

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

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

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

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

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

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. 定義表格數(shù)據(jù)
        string[] header = { "產(chǎn)品ID", "產(chǎn)品名稱", "單價", "數(shù)量" };
        string[][] data =
        {
            new string[] { "P001", "筆記本電腦", "8999.00", "1" },
            new string[] { "P002", "無線鼠標(biāo)", "129.00", "2" },
            new string[] { "P003", "機械鍵盤", "459.00", "1" }
        };

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

        // 設(shè)置表頭樣式
        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);

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

        // 5. 將數(shù)據(jù)填充到表格
        table.DataSource = data;

        // 6. 設(shè)置表格的列寬 (可選，不設(shè)置則自動調(diào)整)
        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)); // 在頁面坐標(biāo)(50, 50)處繪制表格

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

代碼解釋：

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

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

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

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)"));

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

        PdfTableRow row2 = table.Rows.Add();
        row2.Cells[0].Value = "2";
        row2.Cells[1].Value = "任務(wù)B";
        row2.Cells[2].Value = "開發(fā)模塊X";
        row2.Cells[3].Value = "進行中";
        // 設(shè)置特定單元格背景色和字體
        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 = "任務(wù)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; // 合并當(dāng)前單元格及其右側(cè)一個單元格
        row4.Cells[2].Value = "3個任務(wù)";
        row4.Cells[3].Value = ""; // 可以留空或設(shè)置其他內(nèi)容
        row4.Height = 25; // 設(shè)置行高
        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);


        // 設(shè)置表頭樣式
        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 填充單元格數(shù)據(jù)。
row.Cells[index].Style：可以針對單個單元格設(shè)置獨立的樣式，覆蓋表格的默認(rèn)樣式。
row.Cells[index].ColumnSpan：實現(xiàn)單元格橫向合并，值為需要合并的列數(shù)。
row.Height：設(shè)置特定行的高度。

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

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

假設(shè)我們有一個 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
{
    // 模擬數(shù)據(jù)源
    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);

        // 設(shè)置表頭樣式
        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);

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

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

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

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

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

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

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;

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

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

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

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

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

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

總結(jié)

通過本文的詳細(xì)講解和代碼示例，你已經(jīng)掌握了使用C#和Spire.PDF for .NET庫在PDF文檔中創(chuàng)建各種類型表格的核心技術(shù)。從簡單的靜態(tài)表格到復(fù)雜的動態(tài)數(shù)據(jù)表格，再到精細(xì)的單元格樣式定制和跨頁處理，Spire.PDF都提供了強大且直觀的API支持。

C#結(jié)合專業(yè)PDF處理庫，為開發(fā)者在處理PDF文檔時帶來了前所未有的高效與靈活性。我鼓勵你根據(jù)本文提供的示例，進一步探索Spire.PDF的更多功能，例如添加頁眉頁腳、圖片、條形碼等，并將其靈活應(yīng)用于你的實際項目中，為你的應(yīng)用程序帶來更專業(yè)、更強大的PDF文檔處理能力。

到此這篇關(guān)于C#高效創(chuàng)建PDF表格的實用技巧的文章就介紹到這了,更多相關(guān)C#創(chuàng)建PDF表格內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: