藉助 C# 創建專業 PDF 表格：完整示例與技巧詳情 - 數據,C,PDF,.NET,表格,.Net,後端開發,yyds乾貨盤點 mb689bf7a82caf3 博客

藉助 C# 創建專業 PDF 表格：完整示例與技巧_數據

在現代商業應用中，PDF文檔因其跨平台、內容固定和易於共享的特性，成為信息傳遞的重要載體。無論是財務報表、發票、合同，還是產品目錄，結構化的數據往往需要以表格的形式呈現。手動創建這些PDF表格不僅效率低下，而且極易出錯。幸運的是，藉助C#編程，我們可以自動化這一過程，實現高效、精確的PDF表格生成。

本文將深入探討如何使用一款功能強大的PDF處理庫——Spire.PDF for .NET，在C#中創建和定製PDF表格。我們將從基礎的表格構建開始，逐步講解樣式設置、單元格合併、動態數據綁定等進階功能，旨在為開發者提供一份從入門到精通的實踐指南。

一、準備工作與基礎表格創建

首先，我們需要將Spire.PDF for .NET庫集成到我們的C#項目中。最便捷的方式是通過NuGet包管理器：

Install-Package Spire.PDF

安裝完成後，我們就可以開始創建最簡單的PDF表格了。Spire.PDF庫提供了PdfTable類來表示表格，並通過PdfTableColumn和數據填充來構建表格內容。

下面是一個創建2行3列基礎表格的示例：

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

public class BasicTableExample
{
    public static void CreateSimpleTable()
    {
        // 創建PDF文檔
        PdfDocument doc = new PdfDocument();
        // 添加一個頁面
        PdfPageBase page = doc.Pages.Add();

        // 創建PdfTable實例
        PdfTable table = new PdfTable();

        // 定義表格列
        table.Columns.Add(new PdfTableColumn("Header 1"));
        table.Columns.Add(new PdfTableColumn("Header 2"));
        table.Columns.Add(new PdfTableColumn("Header 3"));

        // 準備表格數據
        string[,] data = 
        {
            { "Row 1, Cell 1", "Row 1, Cell 2", "Row 1, Cell 3" },
            { "Row 2, Cell 1", "Row 2, Cell 2", "Row 2, Cell 3" }
        };

        // 設置表格數據源
        table.DataSource = data;

        // 繪製表格到PDF頁面，並指定位置
        table.Draw(page, new PointF(50, 50));

        // 保存PDF文檔
        doc.SaveToFile("SimpleTable.pdf");
        doc.Close();
        System.Diagnostics.Process.Start("SimpleTable.pdf");
    }
}

核心API提示:

PdfDocument: PDF文檔的頂層對象。

PdfPageBase: 代表PDF文檔中的一個頁面。

PdfTable: 用於創建和管理PDF表格。

PdfTableColumn: 定義表格的列，可以設置列標題。

table.DataSource: 可以接受二維數組、DataTable或自定義對象集合作為數據源。

二、表格樣式與佈局進階

一個美觀且易讀的表格離不開精心的樣式設計。Spire.PDF允許我們精細控制表格的邊框、背景色、字體樣式以及單元格的合併與對齊。

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

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

        PdfTable table = new PdfTable();

        // 定義列並設置列寬
        table.Columns.Add(new PdfTableColumn("產品名稱") { Width = 100 });
        table.Columns.Add(new PdfTableColumn("單價") { Width = 60 });
        table.Columns.Add(new PdfTableColumn("數量") { Width = 60 });
        table.Columns.Add(new PdfTableColumn("小計") { Width = 80 });

        // 設置表格邊框
        table.Style.BorderPen = new PdfPen(Color.Black, 0.5f);
        table.Style.CellPadding = 5; // 單元格內邊距

        // 設置表頭樣式
        table.Style.HeaderSource = PdfHeaderSource.Rows;
        table.Style.HeaderRowCount = 1; // 第一行為表頭
        table.Style.ShowHeader = true;
        table.Style.HeaderStyle.BackgroundBrush = PdfBrushes.DarkSlateGray; // 表頭背景色
        table.Style.HeaderStyle.TextBrush = PdfBrushes.White; // 表頭文字顏色
        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.BackgroundBrush = PdfBrushes.LightGray;

        // 設置交替行樣式，提升可讀性
        table.Style.AlternateStyle = new PdfCellStyle();
        table.Style.AlternateStyle.BackgroundBrush = PdfBrushes.WhiteSmoke;

        // 準備數據
        string[,] data =
        {
            { "筆記本電腦", "8999.00", "1", "8999.00" },
            { "機械鍵盤", "799.00", "2", "1598.00" },
            { "無線鼠標", "299.00", "3", "897.00" },
            { "總計", "", "", "11494.00" }
        };
        table.DataSource = data;

        // 合併“總計”行的單元格
        // 合併第4行（索引為3）的第2列到第3列
        table.MergeCells(3, 1, 3, 2); 
        
        // 設置合併後單元格的文本對齊方式
        table.Rows[3].Cells[1].StringFormat = new PdfStringFormat(PdfTextAlignment.Right, PdfVerticalAlignment.Middle);

        table.Draw(page, new PointF(50, 50));

        doc.SaveToFile("StyledTable.pdf");
        doc.Close();
        System.Diagnostics.Process.Start("StyledTable.pdf");
    }
}

樣式控制要點:

table.Style.BorderPen: 設置表格整體邊框的畫筆。

table.Style.CellPadding: 設置單元格內邊距。

table.Style.HeaderStyle: 控制表頭樣式，包括背景、字體、對齊等。

table.Style.DefaultStyle: 設置非表頭單元格的默認樣式。

table.Style.AlternateStyle: 用於設置交替行的樣式，常用於提升表格可讀性。

table.MergeCells(startRow, startColumn, endRow, endColumn): 合併指定範圍的單元格。

PdfStringFormat: 精確控制文本的水平和垂直對齊方式。

三、動態數據綁定與複雜場景

在實際應用中，表格數據通常來源於數據庫、API或其他動態源。Spire.PDF支持將DataTable或自定義對象集合直接綁定到PdfTable，極大地簡化了數據處理。

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

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

        // 創建一個DataTable作為數據源
        DataTable dataTable = new DataTable();
        dataTable.Columns.Add("ID", typeof(int));
        dataTable.Columns.Add("姓名", typeof(string));
        dataTable.Columns.Add("年齡", typeof(int));
        dataTable.Columns.Add("城市", typeof(string));

        // 填充數據
        dataTable.Rows.Add(1, "張三", 30, "北京");
        dataTable.Rows.Add(2, "李四", 25, "上海");
        dataTable.Rows.Add(3, "王五", 35, "廣州");
        dataTable.Rows.Add(4, "趙六", 28, "深圳");
        dataTable.Rows.Add(5, "錢七", 40, "杭州");
        // 更多數據...

        PdfTable table = new PdfTable();
        // 直接綁定DataTable
        table.DataSource = dataTable;

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

        // 設置表頭樣式
        table.Style.HeaderStyle.BackgroundBrush = PdfBrushes.DarkBlue;
        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);

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

        // 處理大數據量時的分頁（簡要提及）
        // 當表格內容超出當前頁面時，Spire.PDF會自動進行分頁。
        // 可以通過 PdfTableLayoutFormat 控制分頁行為，例如設置重複表頭：
        PdfTableLayoutFormat format = new PdfTableLayoutFormat();
        format.Break = PdfLayoutBreakType.FitPage; // 自動適應頁面
        format.Layout = PdfLayoutType.Paginate; // 啓用分頁
        table.Style.RepeatHeader = true; // 每頁重複表頭

        table.Draw(page, new PointF(50, 50), format); // 繪製時傳入佈局格式

        doc.SaveToFile("DynamicTableFromDataTable.pdf");
        doc.Close();
        System.Diagnostics.Process.Start("DynamicTableFromDataTable.pdf");
    }
}

動態綁定與分頁:

table.DataSource = dataTable;: 將DataTable直接賦值給DataSource屬性，Spire.PDF會自動識別列名作為表頭，並填充數據。

PdfTableLayoutFormat: 用於控制表格的佈局和分頁行為，是處理大數據量表格的關鍵。

table.Style.RepeatHeader = true;: 在表格分頁時，確保每一頁的頂部都顯示錶頭，極大地提升了報表的閲讀體驗。

圖片和超鏈接: Spire.PDF也支持在單元格中插入PdfImage或PdfUriAnnotation來添加圖片和超鏈接，這使得報表內容更加豐富。

四、提升用户體驗與性能考量

在開發過程中，除了功能實現，我們還需要關注性能和代碼的健壯性。

性能優化: 頻繁創建字體對象會消耗資源。建議將常用的PdfTrueTypeFont實例緩存起來，避免重複創建。對於大型表格，合理設置PdfTableLayoutFormat的分頁參數，可以優化渲染速度。
錯誤處理: 在實際項目中，應加入必要的try-catch塊來處理文件操作、數據綁定等可能發生的異常，確保程序的穩定性。
代碼健壯性: 檢查數據源的有效性，防止空引用或格式錯誤導致的問題。
表格模板: 對於結構相似但內容不同的報表，可以考慮設計表格模板。預設好表格的樣式、列定義，然後根據不同的數據源動態填充，提高代碼複用性。

總結

通過本文的講解，我們深入瞭解瞭如何利用C#和Spire.PDF for .NET庫在PDF文檔中創建功能豐富、樣式多樣的表格。從基礎的表格構建到複雜的樣式控制、動態數據綁定和分頁處理，Spire.PDF提供了一整套強大且易用的API，極大地簡化了PDF報表的開發工作。

自動化生成PDF表格不僅能夠提高開發效率，減少人工錯誤，還能為企業提供更靈活、更專業的文檔輸出方案。希望這篇教程能幫助您在C#項目中輕鬆應對PDF表格的生成需求。

mb689bf7a82caf3 博客

mb689bf7a82caf3 博客

博客 / 詳情