目前的Winform分頁控件中，目前導出的資料一般使用Excel來處理，Excel的文檔可以用于後期的資料展示或者批量導入做準備，是以是比較好的輸入輸出格式。但是有架構的使用客戶希望分頁控件能夠直接導出PDF，雖然Excel也可以直接轉換為PDF，不過直接導出PDF的處理肯定更加友善直覺。是以整理了一下分頁控件導出PDF的處理過程，分享一下。

PS：給大家推薦一個C#開發可以用到的界面元件——DevExpress WinForms，它能完美建構流暢、美觀且易于使用的應用程式，無論是Office風格的界面，還是分析處理大批量的業務資料，它都能輕松勝任！

DevExpress Universal Subscription官方最新版免費下載下傳試用，曆史版本下載下傳，線上文檔和幫助檔案下載下傳-慧都網

PDF的導出插件

使用PDF導出的插件有很多，如Aspose.PDF、Spire.PDF、PdfSharp、iTextSharp等等很多，有些是收費的，有些是開源免費的，我們這裡使用iTextSharp開源元件進行PDF的導出處理操作。

在測試的時候，我們可以對一個表格内容進行資料的導出，以便驗證效果，然後在考慮整合到分頁控件的内部中使用，如下測試界面所示。

大概的效果如下所示。

如果需要，我們可以進一步定義頁眉和頁腳，增加一些特殊的資訊等等。

我們可以測試導出清單中的DataTable資料源，如下所示。

private void btnExportPdf_Click(object sender, EventArgs e)
{
//帶參數處理
bool isLandscape = true;//是否為橫向列印，預設為true
bool includeHeader = true;//是否每頁包含表頭資訊
int headerAlignment = Element.ALIGN_CENTER;//頭部的對其方式，預設為居中對齊
float headerFontSize = 9f;//頭部字型大小
float rowFontSize = 9f;//行記錄字型大小
float? headerFixHeight = null;//頭部的固定高度，否則為自适應
TextSharpHelper.ExportPdf(isLandscape, includeHeader, headerAlignment, headerFontSize, rowFontSize, headerFixHeight);
}

導出PDF的邏輯處理

上面的操作，對輔助類TextSharpHelper.ExportPdf 的操作進行封裝了，我們可以看到，方法留出了幾個特殊的配置資訊，可供我們進行調整格式。

一般使用清單的輸出為橫向較為美觀，字型比正常窗體顯示的字型小一點，并可以設定是否每頁PDF包含表頭資訊等等。

輔助類的全部代碼如下所示：

/// <summary>
/// 基于iTextSharp.text.pdf對PDF的導出處理
/// </summary>
public static class TextSharpHelper
{
/// <summary>
/// datatable轉PDF方法
/// </summary>
/// <param name="data">dataTable資料</param>
/// <param name="pdfFile">PDF檔案儲存的路徑</param>
/// <param name="isLandscape">是否為橫向列印，預設為true</param>
/// <param name="includeHeader">是否每頁包含表頭資訊</param>
/// <param name="headerAlignment">頭部的對其方式，預設為居中對齊</param>
/// <param name="headerFontSize">頭部字型大小</param>
/// <param name="rowFontSize">行記錄字型大小</param>
/// <param name="headerFixHeight">頭部的固定高度，否則為自适應</param>
/// <returns></returns>
public static bool ExportTableToPdf(DataTable data, string pdfFile, bool isLandscape = true, bool includeHeader = true, int headerAlignment = Element.ALIGN_CENTER, float headerFontSize = 9f, float rowFontSize = 9f, float? headerFixHeight = null)
{
//預設頁面大小
var document = new Document();
var retangle = new iTextSharp.text.Rectangle(0, 0, isLandscape ? PageSize.A4.Height : PageSize.A4.Width, isLandscape ? PageSize.A4.Width : PageSize.A4.Height);
document.SetPageSize(retangle);
var writer = PdfWriter.GetInstance(document, new FileStream(pdfFile, FileMode.Create));
document.Open();

//設定字型
var bfChinese = BaseFont.CreateFont("C:\\WINDOWS\\Fonts\\simsun.ttc,1", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
var fontHeader = new iTextSharp.text.Font(bfChinese, headerFontSize, iTextSharp.text.Font.BOLD, new BaseColor(0, 0, 0));
var fontRow = new iTextSharp.text.Font(bfChinese, rowFontSize, iTextSharp.text.Font.NORMAL, new BaseColor(0, 0, 0));

var table = new PdfPTable(data.Columns.Count);
table.WidthPercentage = 100f; // percentage
table.DefaultCell.Padding = 1;
table.DefaultCell.BorderWidth = 1;
table.DefaultCell.BorderWidth = 0.1f;
table.DefaultCell.HorizontalAlignment = Element.ALIGN_LEFT;
table.HeaderRows = includeHeader ? 1 : 0;

//将datatable表頭轉換成PDFTable的表頭
var EventRowBackColor = Color.LightCyan;
foreach (DataColumn dc in data.Columns)
{
var caption = !string.IsNullOrEmpty(dc.Caption) ? dc.Caption : dc.ColumnName;

var cell = new PdfPCell();
if (headerFixHeight.HasValue)
{
cell.FixedHeight = headerFixHeight.Value;
}
cell.HorizontalAlignment = headerAlignment;
cell.VerticalAlignment = Element.ALIGN_MIDDLE;
cell.Phrase = new Phrase(caption, fontHeader);
table.AddCell(cell);
}

//插入資料
for (int i = 0; i < data.Rows.Count; i++)
{
var backgroudColor = new BaseColor((i % 2 == 0) ? Color.White : EventRowBackColor);
for (int j = 0; j < data.Columns.Count; j++)
{
var cell = new PdfPCell();
var text = data.Rows[i][j].ToString();
cell.BackgroundColor = backgroudColor;
cell.Phrase = new Phrase(text, fontRow);
table.AddCell(cell);
}
}
document.Add(table);
document.Close();
writer.Close();
return true;
}
}

上面根據方法的參數對字型，頁面寬度高度、表格間隔顔色，表頭等資訊進行設定處理，然後使用插件進行輸出PDF的内容即可，PDF内容的輸出，有點類似DataTable的表格控制，單元格的資訊可以獨立控制。

為了不用重複的引用代碼或者輔助類，我們可以整合到分頁控件的清單中，在其中封裝處理邏輯即可，這樣所有清單都具有通用的導出PDF操作了，如下界面所示。

我們一般導出是通過事件進行處理的，是以，我們在底部的分頁中定義一個觸發的事件，如下所示。

public delegate void ExportPdfEventHandler(object sender, EventArgs e);
/// <summary>
/// 分頁工具條使用者控件，僅提供分頁資訊顯示及改變頁碼操作
/// </summary>
public class Pager : DevExpress.XtraEditors.XtraUserControl
{
/// <summary>
/// 導出PDF的事件
/// </summary>
public event ExportPdfEventHandler ExportPdf;

按鈕單擊的時候，觸發事件的處理，如下代碼所示。

private void btnExportPdf_Click(object sender, EventArgs e)
{
if (ExportPdf != null)
{
ExportPdf(sender, e);
}
}

這樣事件會傳遞到外面的容器元件中，對容器元件中的資料源進行導出處理即可。

private void WinGridViewPager_Load(object sender, EventArgs e)
{
if (!this.DesignMode)
{
this.pager.PageChanged += new PageChangedEventHandler(pager_PageChanged);
this.pager.ExportCurrent += new ExportCurrentEventHandler(pager_ExportCurrent);
this.pager.ExportAll += new ExportAllEventHandler(pager_ExportAll);
this.pager.ExportPdf += Pager_ExportPdf;

對于清單的資料源，我們可以統一轉換為DataTable格式，如下分析資料源的格式進行轉換。

DataTable sourcetable = null;
if (this.DataSource is DataView)
{
DataView dv = (DataView)AllToExport;//預設導出顯示内容
sourcetable = dv.ToTable();
}
else if (this.DataSource is DataTable)
{
sourcetable = this.DataSource as DataTable;
}
else
{
sourcetable = ReflectionUtil.CreateTable(this.DataSource);
}

而對于表格内容的中文注釋，我們可以讀取表格裡面的頭部資訊作為PDF表頭的中文資訊，如下所示。

var table = new DataTable();
for (int i = 0; i < this.gridView1.Columns.Count; i++)
{
if (this.gridView1.Columns[i].Visible)
{
var column = new DataColumn(this.gridView1.Columns[i].FieldName, typeof(string));
column.Caption = this.gridView1.Columns[i].Caption;
table.Columns.Add(column);
}
}

而每行的内容，可以逐一讀取并寫入其中即可。

for (int i = 0; i < sourcetable.Rows.Count; i++)
{
var row = table.NewRow();
for (int j = 0; j < table.Columns.Count; j++)
{
var columnName = table.Columns[j].ColumnName;
var displayText = this.gridView1.GetRowCellDisplayText(i, columnName);
row[columnName] = displayText ?? "";
}
table.Rows.Add(row);
}

最後調用輔助類進行導出PDF文檔即可，導出後進行打開處理。

var success = TextSharpHelper.ExportTableToPdf(table, pdfFile, isLandscape, includeHeader, headerAlignment, headerFontSize, rowFontSize, headerFixHeight);
if (success)
{
Process.Start(pdfFile);
}

導出PDF和前面的效果一樣了。

如果是基于.net 4.8或者基于.netcore的，還可以選擇這個控件的更新版本itext7進行導出PDF，它的處理方式有些差異，如下代碼所示。

/// <summary>
/// datatable轉PDF方法
/// </summary>
/// <param name="title">标題内容</param>
/// <param name="data">dataTable資料</param>
/// <param name="pdfFile">PDF檔案儲存的路徑</param>
/// <param name="isLandscape">是否為橫向列印，預設為true</param>
/// <param name="includeHeader">是否每頁包含表頭資訊</param>
/// <param name="headerAlignment">頭部的對其方式，預設為居中對其</param>
/// <param name="headerFontSize">頭部字型大小</param>
/// <param name="rowFontSize">行記錄字型大小</param>
/// <param name="headerFixHeight">頭部的固定高度，否則為自适應</param>
/// <returns></returns>
public static bool ExportTableToPdf(string title , DataTable data, string pdfFile,bool isLandscape = true, bool includeHeader = true, iText.Layout.Properties.HorizontalAlignment headerAlignment = iText.Layout.Properties.HorizontalAlignment.CENTER, float headerFontSize = 9f, float rowFontSize = 9f, float? headerFixHeight = null)
{
//字型注冊隻需要一次-- 宋體(新宋體)
PdfFontFactory.Register("C:\\WINDOWS\\Fonts\\simsun.ttc");

var writer = new PdfWriter(pdfFile);
PdfDocument pdf = new PdfDocument(writer);
pdf.SetDefaultPageSize(isLandscape ? PageSize.A4.Rotate() : PageSize.A4); //A4橫向
var doc = new Document(pdf);

//宋體(新宋體)
var sysFont = PdfFontFactory.CreateRegisteredFont("simsun", PdfEncodings.IDENTITY_H, PdfFontFactory.EmbeddingStrategy.PREFER_EMBEDDED, true);
doc.SetFont(sysFont).SetFontSize(12);//設定字型大小

//設定标題
if (!string.IsNullOrEmpty(title))
{
var param = new Paragraph(title)
.SetFontColor(iText.Kernel.Colors.ColorConstants.BLACK)
.SetBold() //粗體
.SetFontSize(headerFontSize + 5)
.SetTextAlignment(TextAlignment.CENTER); //居中
doc.Add(param);
}

var table = new Table(data.Columns.Count)
.SetTextAlignment(TextAlignment.CENTER)
.SetVerticalAlignment(VerticalAlignment.MIDDLE)
.SetWidth(new UnitValue(UnitValue.PERCENT, 100));//縮放比例
table.UseAllAvailableWidth();

//添加表頭
foreach (DataColumn dc in data.Columns)
{
var caption = !string.IsNullOrEmpty(dc.Caption) ? dc.Caption : dc.ColumnName;
var cell = new Cell().Add(new Paragraph(caption))
.SetBold()
.SetVerticalAlignment(VerticalAlignment.MIDDLE)
.SetHorizontalAlignment(headerAlignment)
.SetPadding(1)
.SetFontSize(headerFontSize);

if (headerFixHeight.HasValue)
{
cell.SetHeight(new UnitValue(UnitValue.POINT, headerFixHeight.Value));
}
table.AddHeaderCell(cell);
}

//插入資料
var colorWhite = Color.ConvertRgbToCmyk(iText.Kernel.Colors.WebColors.GetRGBColor("White"));// System.Drawing.Color.White;
var colorEvent= iText.Kernel.Colors.WebColors.GetRGBColor("LightCyan");// System.Drawing.Color.LightCyan;
var EventRowBackColor = Color.ConvertRgbToCmyk(colorEvent);
for (int i = 0; i < data.Rows.Count; i++)
{
table.StartNewRow();//第一列開啟新行
var backgroudColor = ((i % 2 == 0) ? colorWhite : EventRowBackColor);
for (int j = 0; j < data.Columns.Count; j++)
{
var text = data.Rows[i][j].ToString();
var cell = new Cell()
.SetBackgroundColor(backgroudColor)
.SetFontSize(rowFontSize)
.SetVerticalAlignment(VerticalAlignment.MIDDLE)
.Add(new Paragraph(text));

table.AddCell(cell);
}
}

doc.Add(table);
pdf.Close();
writer.Close();
return true;
}

測試界面效果如下所示。

注意itext7 使用，必須引入中文字型，否則标題的中文内容不會正常顯示出來。

本文轉載自：部落格園 - 伍華聰

WinForm應用實戰開發指南 - 在分頁控件中內建導出PDF文檔功能

PDF的導出插件

導出PDF的邏輯處理

繼續閱讀

打造屬于你的DApp：從零開始的開發指南

Boost程式庫完全開發指南第二章時間與日期

Boost程式庫完全開發指南第三章記憶體管理

6月結束了，程式員這個月軟體開發項目接得不是太理想，比起4.5月份差了一些，接了兩個定制開發的項目。然後接了四個是現成的

Java并發工具探秘：Fork/Join架構及其進階應用實戰

分批次處理String[]數組

《精益産品開發手冊》：靈活、靈活、創新的産品開發指南

應用安全開發指南（資料脫敏/安全開發/修複方案）

榮耀MagicPad13作為一款生産力躍遷的旗艦平闆，完美契合了目前消費者移動辦公的需求，抓住了大螢幕+兩個核心辦公場景

深入探索和分析MySQL資料庫的資料備份和恢複實戰開發指南

品源智道.原創.定向智道.新零售闆塊涉獵：針對《新店商終端赢道.方略108悟道》.元素《全息三維數字投影.剖析.拆分體系

從前慢-開發問題指南前言開發問題指南

Python網絡程式設計與Web開發指南

開發指南_野火指南者開發闆移植 lvgl 庫

企業微信更新到4.1.8版本導緻老的win7系統也沒法用文檔功能了。很多小企業仍然為了節省硬體成本在使用老舊的32位wi

#打卡不停更# OpenHarmony - 應用開發入門指南