C#實現(xiàn)精準(zhǔn)拆分PDF頁面(單頁/指定頁)的完整代碼
在處理 PDF 文檔時,“拆分頁面”可以說是最常遇到的需求之一。比如:一份幾十頁的報告,你只想要其中某一章;或者開會發(fā)的 PDF 會議紀(jì)要,需要按參會者姓名拆成單頁分別發(fā)郵件;又或者你剛把一份掃描件導(dǎo)出來,希望每一頁變成一個獨立的 PDF 文件……這些場景我都遇到過。
今天我就用 Free Spire.PDF for .NET 這個免費庫,把 C# 里拆分 PDF 的各種姿勢都講一遍。代碼都是實際跑過的,你復(fù)制過去改改路徑就能用。
安裝:在 NuGet 包管理器里搜 FreeSpire.PDF 直接安裝就行。這是一個免費社區(qū)版,唯一的限制是單次處理不能超過 10 頁,如果超過 10 頁,后面的頁會被悄悄截掉(不會報錯,但結(jié)果會少頁)。所以如果你只是偶爾處理小文件,這個庫很順手。
原理
拆 PDF 其實就四步:
- 把原 PDF 讀進來
- 決定要拆出哪些頁(單頁、一個范圍、或者抽幾頁)
- 新建一個空的 PDF 對象,把選中的頁面“復(fù)制”進去
- 保存成新文件
Free Spire.PDF 提供了一個 PdfDocument 類,里面的 Pages 集合就像數(shù)組一樣,你可以按索引取出每一頁,然后插入到另一個文檔里。下面我會用實際代碼演示。
每一頁單獨存一個 PDF
如果你的目標(biāo)就是“把一份 PDF 的每一頁拆成單獨的文件”,這個庫內(nèi)置了一個 Split 方法,一行調(diào)用就能搞定。
using Spire.Pdf;
namespace SplitPdfDemo
{
internal class Program
{
static void Main(string[] args)
{
PdfDocument pdf = new PdfDocument();
pdf.LoadFromFile("D:\\測試文檔.pdf");
// 注意:模板里必須寫 {0},這是編號占位符
// 比如 "page_{0}.pdf" 會生成 page_1.pdf, page_2.pdf ...
pdf.Split("C:\\output\\page_{0}.pdf", 1);
pdf.Close();
Console.WriteLine("拆分完成,請去 output 文件夾查看");
}
}
}一點小經(jīng)驗:Split 方法第二個參數(shù) startNumber 我一般就填 1,這樣文件名看起來更自然。如果你填 0,第一個文件就會變成 page_0.pdf,容易引起困惑。
每 N 頁合并成一個 PDF(比如每 3 頁一個文件)
有時候我們不是要“每頁一個文件”,而是“每幾頁合成一個文件”。比方說,你把掃描儀設(shè)置成了連續(xù)進紙,每 3 頁是一份合同,那么拆分時就要按 3 頁一組來切。
這時候 Split 就不管用了,得我們自己動手循環(huán)。
代碼
using Spire.Pdf;
using System;
namespace SplitPdf
{
internal class Program
{
static void Main(string[] args)
{
string inputFile = "sample.pdf";
int pagesPerGroup = 3; // 每3頁一組
string outputPattern = "Group_{0}.pdf";
PdfDocument source = new PdfDocument();
source.LoadFromFile(inputFile);
int totalPages = source.Pages.Count;
int groupCount = (int)Math.Ceiling((double)totalPages / pagesPerGroup);
for (int g = 0; g < groupCount; g++)
{
PdfDocument groupDoc = new PdfDocument();
int startIdx = g * pagesPerGroup; // 起始索引(0基)
int endIdx = Math.Min(startIdx + pagesPerGroup - 1, totalPages - 1);
for (int i = startIdx; i <= endIdx; i++)
{
groupDoc.InsertPage(source, source.Pages[i]);
}
string outputFile = string.Format(outputPattern, g + 1);
groupDoc.SaveToFile(outputFile);
groupDoc.Close();
Console.WriteLine($"已生成:{outputFile}");
}
source.Close();
Console.WriteLine($"全部完成,共生成 {groupCount} 個文件");
}
}
}其他常用拆分玩法
提取不連續(xù)的幾頁(例如第 2、5、7 頁)
有時候你只想抽幾頁出來做成一個新 PDF,比如從合同里只把簽字頁拿出來。
PdfDocument source = new PdfDocument();
source.LoadFromFile("合同.pdf");
PdfDocument result = new PdfDocument();
int[] wantedPages = { 2, 5, 7 }; // 這里的數(shù)字是頁碼(從1開始)
foreach (int pageNum in wantedPages)
{
// 注意:Pages 集合的索引是從0開始的,所以要減1
if (pageNum >= 1 && pageNum <= source.Pages.Count)
{
result.InsertPage(source, source.Pages[pageNum - 1]);
}
else
{
Console.WriteLine($"警告:第{pageNum}頁不存在,已跳過");
}
}
result.SaveToFile("提取的簽字頁.pdf");
result.Close();
source.Close();一個小坑:如果你傳入的頁碼超出范圍,代碼不會自動報錯,只是那頁不會被復(fù)制。所以我加了一個 if 判斷并打印警告,避免你“以為復(fù)制了其實沒有”。
提取所有奇數(shù)頁 / 偶數(shù)頁
比如一份雙面掃描的文檔,你想把奇數(shù)頁和偶數(shù)頁分開處理。
PdfDocument source = new PdfDocument();
source.LoadFromFile("雙面掃描件.pdf");
PdfDocument oddPages = new PdfDocument(); // 奇數(shù)頁(第1、3、5...)
PdfDocument evenPages = new PdfDocument(); // 偶數(shù)頁(第2、4、6...)
for (int i = 0; i < source.Pages.Count; i++) // i 是0基索引
{
// 第1頁的索引是0,第2頁索引是1,依此類推
if (i % 2 == 0)
oddPages.InsertPage(source, source.Pages[i]);
else
evenPages.InsertPage(source, source.Pages[i]);
}
oddPages.SaveToFile("奇數(shù)頁.pdf");
evenPages.SaveToFile("偶數(shù)頁.pdf");
oddPages.Close();
evenPages.Close();
source.Close();這里容易混淆的是:索引 i=0 對應(yīng)第1頁(奇數(shù)頁),所以 i%2==0 是奇數(shù)頁。
和其他庫簡單對比一下(個人感受)
| 庫 | 許可 | 優(yōu)點 | 缺點 |
|---|---|---|---|
| Free Spire.PDF | 免費社區(qū)版 | API 很直觀,不需要裝 Adobe,頁面復(fù)制時注釋、表單、書簽都保留得不錯。 | 10頁限制,超過就截斷(這是硬傷) |
| iTextSharp | AGPL | 功能最強,工業(yè)級。 | AGPL 許可證對商業(yè)項目很不友好,想商用必須買授權(quán),而且配置略繁瑣。 |
| PdfSharp | MIT | 完全免費無限制,輕量。 | 頁面復(fù)制的效果一般,有些復(fù)雜元素(比如某些字體或透明度)會丟失。 |
我個人建議:如果你只是偶爾處理一些 ≤10 頁的 PDF,F(xiàn)ree Spire.PDF 最省心。如果經(jīng)常處理幾十頁的文件又不想花錢,可以試試 PdfSharp,但要做好“部分樣式丟失”的心理準(zhǔn)備。
方法補充
在 C# 中拆分 PDF 文件的需求多種多樣,例如從多頁 PDF 中提取某一頁、將大文件按固定頁數(shù)分成多個小文件、或者按頁碼列表提取特定頁面。本文將展示使用 PdfSharp(免費開源,推薦)、iTextSharp(LGPL/AGPL,需注意許可)和 Spire.PDF(商業(yè)庫,功能豐富)這三種庫,實現(xiàn)常見的拆分場景。
提醒:生產(chǎn)環(huán)境建議優(yōu)先使用 PdfSharp(MIT 協(xié)議)或購買商業(yè)庫。iTextSharp 的 AGPL 協(xié)議要求公開源代碼,需謹(jǐn)慎使用。
使用 PdfSharp(免費、輕量)
PdfSharp 是一款純 .NET 的 PDF 操作庫,無需安裝 Adobe 軟件,支持 .NET Framework / .NET Core。
安裝 NuGet 包:
Install-Package PdfSharp
場景1:按單頁拆分(每頁保存為一個單獨的 PDF)
using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
public static void SplitPdfByPage(string inputFile, string outputFolder)
{
// 打開源 PDF 文檔
PdfDocument inputDocument = PdfReader.Open(inputFile, PdfDocumentOpenMode.Import);
for (int i = 0; i < inputDocument.PageCount; i++)
{
// 創(chuàng)建一個新文檔
PdfDocument outputDocument = new PdfDocument();
// 導(dǎo)入第 i 頁(PdfSharp 的頁碼從 1 開始,但 AddPage 需傳入頁面對象)
outputDocument.AddPage(inputDocument.Pages[i]);
// 保存為獨立文件
string outputFile = Path.Combine(outputFolder, $"page_{i + 1}.pdf");
outputDocument.Save(outputFile);
}
}場景2:拆分頁碼范圍(例如第 3-5 頁)
public static void SplitPageRange(string inputFile, string outputFile, int startPage, int endPage)
{
using (PdfDocument input = PdfReader.Open(inputFile, PdfDocumentOpenMode.Import))
{
PdfDocument output = new PdfDocument();
for (int i = startPage - 1; i < endPage && i < input.PageCount; i++)
{
output.AddPage(input.Pages[i]);
}
output.Save(outputFile);
}
}場景3:按固定頁數(shù)拆分(如每 10 頁一個文件)
public static void SplitByChunkSize(string inputFile, int chunkSize)
{
using (PdfDocument input = PdfReader.Open(inputFile, PdfDocumentOpenMode.Import))
{
int totalPages = input.PageCount;
for (int start = 0; start < totalPages; start += chunkSize)
{
PdfDocument chunkDoc = new PdfDocument();
int end = Math.Min(start + chunkSize, totalPages);
for (int i = start; i < end; i++)
{
chunkDoc.AddPage(input.Pages[i]);
}
chunkDoc.Save($"chunk_{start / chunkSize + 1}.pdf");
}
}
}使用 iText 7(功能強大,注意許可)
iText 7 是業(yè)界標(biāo)準(zhǔn),但 AGPL 許可證要求開源,商業(yè)使用需購買許可。
安裝 NuGet 包:
Install-Package itext7
場景:提取指定頁面列表(例如第 1,3,5 頁)
using iText.Kernel.Pdf;
public static void ExtractPagesList(string inputFile, string outputFile, List<int> pageNumbers)
{
using (PdfDocument pdfDoc = new PdfDocument(new PdfReader(inputFile)))
using (PdfDocument outDoc = new PdfDocument(new PdfWriter(outputFile)))
{
foreach (int pageNum in pageNumbers)
{
// iText 頁碼從 1 開始
PdfPage page = pdfDoc.GetPage(pageNum);
outDoc.AddPage(page.CopyTo(outDoc));
}
}
}使用 Spire.PDF(商業(yè)庫,功能最全)
Spire.PDF 提供豐富的 API,免費版有頁數(shù)限制。
安裝 NuGet 包:
Install-Package Spire.PDF
場景:根據(jù)書簽拆分(按章節(jié)拆分)
using Spire.Pdf;
using Spire.Pdf.Bookmarks;
public static void SplitByBookmarks(string inputFile)
{
PdfDocument doc = new PdfDocument();
doc.LoadFromFile(inputFile);
PdfBookmarkCollection bookmarks = doc.Bookmarks;
for (int i = 0; i < bookmarks.Count; i++)
{
PdfDocument newDoc = new PdfDocument();
int startPage = bookmarks[i].Destination.PageNumber;
int endPage = (i == bookmarks.Count - 1) ? doc.Pages.Count : bookmarks[i + 1].Destination.PageNumber - 1;
// 復(fù)制頁面
for (int p = startPage; p <= endPage; p++)
{
newDoc.InsertPage(newDoc.Pages.Count, doc.Pages[p - 1]); // Spire 頁碼從 1 開始
}
newDoc.SaveToFile($"chapter_{i + 1}.pdf");
}
}總結(jié)
| 需求 | 使用方法 | 核心 API |
|---|---|---|
| 每頁單獨保存 | pdf.Split("pattern_{0}.pdf", 1) | 內(nèi)置 Split |
| 每 N 頁合為一個文件 | 手動循環(huán) + InsertPage | PdfDocument.InsertPage |
| 按指定頁碼提取 | 手動篩選 + InsertPage | 同上 |
掌握上述模式后,您可以靈活組合出滿足各種業(yè)務(wù)規(guī)則的 PDF 拆分邏輯。代碼均已在實際項目中驗證,可直接復(fù)用。
到此這篇關(guān)于C#實現(xiàn)精準(zhǔn)拆分PDF頁面(單頁/指定頁)的完整代碼的文章就介紹到這了,更多相關(guān)C#拆分PDF內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
基于C#動手實現(xiàn)網(wǎng)絡(luò)服務(wù)器Web Server
這篇文章主要為大家詳細(xì)介紹了基于C#動手實現(xiàn)網(wǎng)絡(luò)服務(wù)器Web Server,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-10-10

