如何在 C# 中使用 IronPDF 來壓縮 PDF
IronPDF通過CompressAndSaveAs方法壓縮C#中的PDF文件，此方法將嵌入圖像重新編碼為JPEG，並可選擇刪除PDF結構樹，以便在一次調用中減小文件大小。 當您不想碰磁碟時，可以使用配套的CompressPdfToStream方法在記憶體中進行相同的工作。
圖像通常佔PDF大小的比例最大，並且涉及大量表格的文件攜帶結構樹，進一步增加了文件重量。 IronPDF同時針對這兩者，因此同樣的調用在從磁碟載入或保持在記憶流中的PDF上都能運行。
快速入門：使用 IronPDF 壓縮 PDF 檔案
使用CompressAndSaveAs以重新編碼其圖像並在一步驟中寫入瘦身後的副本。第二個參數是JPEG品質。
簡化工作流程（3 步驟）
- 從 NuGet 下載用於 PDF 壓縮的 C# 庫
- 匯入現有的 PDF 或渲染新的 PDF
- 調用
CompressAndSaveAs(outputPath, quality, removeStructureTree)來壓縮圖像，選擇性移除結構樹，並保存結果
Compress(CompressionOptions)已被淘汰。
如何壓縮 PDF 中的圖片？
將JPEG CompressAndSaveAs，IronPDF會以該品質重新編碼每個嵌入的圖像。 數值介於0（最大壓縮）到100（最小損失），且底層引擎決定每個數值如何映射到輸出。 這是每當文件攜帶有嵌入圖像時可運用的方法。
作為大致指導：
- 90及以上：高品質
- 80到90：中品質
- 70到80：低品質
較小的數量壓縮更堅固，但可能引入可見的瑕疵，而清晰度下降多少則取決於源圖像，因此請針對您自己的內容測試幾個設置以找到您期望的平衡。
輸入
:path=/static-assets/pdf/content-code-examples/how-to/pdf-compression-image.csusing IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
// Compress images in the PDF
pdf.CompressAndSaveAs("compressed.pdf", 40);Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")
' Compress images in the PDF
pdf.CompressAndSaveAs("compressed.pdf", 40)輸出
圖片壓縮可帶來什麼結果？
在維基渲染上減少了39.24%。
如何壓縮 PDF 樹狀結構？
將CompressAndSaveAs以刪除由Chrome Engine寫入PDF的樹結構。 在包含大量表格的Chrome引擎PDF上節省最多。 一些渲染引擎不會發出此類結構，這意味著沒有東西可供功能移除。
刪除樹可能削弱文字突出顯示和選擇，因此如果讀者日後需要從結果中提取文字和圖像，請在權衡大小優勢時注意這一點。
使用這個PDF表格資料來測試移除樹結構的CompressAndSaveAs。
:path=/static-assets/pdf/content-code-examples/how-to/pdf-compression-tree-structure.csusing IronPdf;
PdfDocument pdf = PdfDocument.FromFile("table.pdf");
// Compress tree structure in PDF
pdf.CompressAndSaveAs("compressedTable.pdf", null, true);Imports IronPdf
Dim pdf As PdfDocument = PdfDocument.FromFile("table.pdf")
' Compress tree structure in PDF
pdf.CompressAndSaveAs("compressedTable.pdf", Nothing, True)樹狀結構壓縮可以達到哪些檔案大小的減少？
減少了67.90%。 這個數字隨著表格PDF增大而上升。
如何同時套用兩種壓縮方法？
在同一true以同時縮小兩個膨脹來源。 在混合圖像和結構資料的文件中，這對可在有圖表的報告或含嵌入表格的發票中很有幫助。
:path=/static-assets/pdf/content-code-examples/how-to/pdf-compression-compress.csusing IronPdf;
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");
// Configure compression with automatic optimization
pdf.CompressAndSaveAs("compressed.pdf", 80, true);Imports IronPdf
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")
' Configure compression with automatic optimization
pdf.CompressAndSaveAs("compressed.pdf", 80, True)CompressAndSaveAs接受的參數有哪些？
-
outputPath(string)：壓縮PDF寫入的文件路徑。 -
quality(int?, 0 到 100)：應用於每張嵌入圖像的JPEG品質。 數值越低，產生的檔案越小。 傳遞null以完全跳過圖像壓縮。 removeStructureTree(bool, 預設為true時，刪除PDF結構樹以進一步減少文件大小。 對於 HTML 產生的帶表格 PDF 最為有效。
令用例調整刻度表。 存檔副本通常偏愛品質高於大小，而網頁發佈獎勵更小的文件。同樣的權衡也適用於壓縮PDF/A合規文件，其中圖像保真度可能是優先考慮的。
如何對壓縮進行細粒度控制？
對於大多數文件，兩參數調用已足夠，但圖像密集的存檔和嚴格的大小預算有時需要更多控制。 將CompressAndSaveAs以調整壓縮管道，包括圖像DPI降取樣、JPEG重新編碼品質和zlib壓縮級別。 較簡單的CompressAndSaveAs(outputPath, quality, removeStructureTree)重載仍然不變地工作，並產生與以往相同的輸出。
using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
// Web or email: strong size reduction
pdf.CompressAndSaveAs("compressed.pdf", new AdvancedCompressionOptions
{
JpegQuality = 70,
TargetImageDpi = 150,
RemoveStructureTree = true
});
// Print quality: minimal quality loss
pdf.CompressAndSaveAs("print.pdf", new AdvancedCompressionOptions
{
JpegQuality = 90,
TargetImageDpi = 300
});using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
// Web or email: strong size reduction
pdf.CompressAndSaveAs("compressed.pdf", new AdvancedCompressionOptions
{
JpegQuality = 70,
TargetImageDpi = 150,
RemoveStructureTree = true
});
// Print quality: minimal quality loss
pdf.CompressAndSaveAs("print.pdf", new AdvancedCompressionOptions
{
JpegQuality = 90,
TargetImageDpi = 300
});Imports IronPdf
Dim pdf = PdfDocument.FromFile("input.pdf")
' Web or email: strong size reduction
pdf.CompressAndSaveAs("compressed.pdf", New AdvancedCompressionOptions With {
.JpegQuality = 70,
.TargetImageDpi = 150,
.RemoveStructureTree = True
})
' Print quality: minimal quality loss
pdf.CompressAndSaveAs("print.pdf", New AdvancedCompressionOptions With {
.JpegQuality = 90,
.TargetImageDpi = 300
})最能驚人效果的兩個屬性是TargetImageDpi：
JpegQuality(int?, 1 到 100, 預設為null)：以此JPEG品質重新編碼圖像。 設為null以完全跳過圖像重新編碼。TargetImageDpi(int?, 預設為150)：重新編碼前降取樣DPI超過此值的圖像。 設定為0以禁用降取樣及保持原始解析度。
推薦的JpegQuality值（僅在設定時應用）：
| 價值 | 使用案例 |
|---|---|
null（預設） |
不進行圖像重新編碼 |
95 |
存檔，最小工件 |
85 |
高品質 |
70 |
平衡，一般使用良好 |
50 |
網頁或電子郵件，更小的文件有可見工件 |
推薦的TargetImageDpi值（有損）：
| 價值 | 使用案例 |
|---|---|
300 |
列印質量，在正常觀看距離下肉眼無損 |
200 |
在高 DPI 和視網膜螢幕上顯得清晰 |
150（預設） |
螢幕和電郵相平衡的最佳尺寸和質量 |
96 |
激進，柔軟的文字但仍可閱讀 |
0 |
禁用，保留原始解析度 |
TargetImageDpi降取樣是有損的：當圖像被降取樣後，其原始解析度不能恢復。 事先決定您想要的解析度減少或僅品質重新編碼，並相應設置TargetImageDpi。如何在不儲存到磁碟的情況下壓縮PDF檔案？
API回應、雲功能和電子郵件附件通常不需要磁碟上的壓縮PDF。 CompressPdfToBytes返回結果為字節陣列，因此您可以決定下一步這些字節位於何處。
:path=/static-assets/pdf/content-code-examples/how-to/pdf-compression-to-bytes.csusing IronPdf;
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");
// Compress and return as byte array
byte[] compressedBytes = pdf.CompressPdfToBytes();
File.WriteAllBytes("compressed.pdf", compressedBytes);Imports IronPdf
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")
' Compress and return as byte array
Dim compressedBytes As Byte() = pdf.CompressPdfToBytes()
File.WriteAllBytes("compressed.pdf", compressedBytes)如果您需要CompressPdfToStream並將其複製到您的目的地。 這適合於將輸出引道到HTTP回應正文、雲儲存上傳或任何基於流的工作流程。
:path=/static-assets/pdf/content-code-examples/how-to/pdf-compression-to-stream.csusing IronPdf;
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");
// Compress and return as Stream
using var compressedStream = pdf.CompressPdfToStream();
using var fileStream = File.Create("compressed.pdf");
compressedStream.CopyTo(fileStream);Imports IronPdf
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")
' Compress and return as Stream
Using compressedStream = pdf.CompressPdfToStream()
Using fileStream = File.Create("compressed.pdf")
compressedStream.CopyTo(fileStream)
End Using
End Using有哪些Compression模式選項可用？
Compression模式作為參數，以決定工作的進行方式。 部署目標在允許磁碟存取方面存在差異，該模式讓您選擇合適的權衡：
| 模式 | 磁碟存取 | 圖像重新取樣 | 輸出大小 |
|---|---|---|---|
自動 (預設) |
嘗試磁碟，回退到記憶體 | 當磁碟可使用時 | 最小的在允許時 |
快記憶體 |
無ne | 無 | 較大 |
高品質 |
需要臨時目錄 | 是 | 最小的 |
FastMemory。 下例強制HighQuality獲得最小輸出，這需要在運行時獲得系統臨時目錄的寫入許可。
:path=/static-assets/pdf/content-code-examples/how-to/pdf-compression-mode.csusing IronPdf;
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");
// HighQuality resamples images using the system temp directory, so it produces
// the smallest output but needs write access to that directory at runtime
byte[] compressedBytes = pdf.CompressPdfToBytes(50, false, CompressionMode.HighQuality);
File.WriteAllBytes("compressed.pdf", compressedBytes);
Imports IronPdf
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")
' HighQuality resamples images using the system temp directory, so it produces
' the smallest output but needs write access to that directory at runtime
Dim compressedBytes As Byte() = pdf.CompressPdfToBytes(50, False, CompressionMode.HighQuality)
File.WriteAllBytes("compressed.pdf", compressedBytes)輸出
CompressPdfToStream現已在所有IronPDF平台上可用，包括Java、無de.js和Python。
結論
您現在擁有一個方法Compression模式下在記憶體中完成相同工作。 自然的下一步是將這些精簡的頁面轉換成縮圖，使用PDF光柵化。
常見問題
透過壓縮PDF文件大小能夠減少多少？
結果因內容而異。在顯示的例子中，圖像壓縮減少了一個文件39.24％，而結構樹的移除使一個表格繁重的PDF減少了67.90％。圖像繁重和表格繁重的文件能夠獲得最大的節省。
IronPDF如何在C#中壓縮PDF？
IronPDF透過單一方法處理壓縮—CompressAndSaveAs。它使用可配置的JPEG品質（0–100）減小嵌入的圖像尺寸，並可以選擇性地設置removeStructureTree: true來剝除PDF內部的結構樹，這對於表格繁重的文件特別有效。
應該使用哪種JPEG壓縮品質水平在PDF中？
IronPDF支持1%至100%的JPEG壓縮品質。推薦的水平是：90%以上為高品質，80%-90%為中等品質，70%-80%為低品質。最佳設置取決於您在文件大小和視覺品質要求之間的平衡。
我可以只用一行程式碼壓縮PDF嗎？
可以，IronPDF允許在一行程式碼中壓縮PDF：PdfDocument.FromFile("input.pdf").CompressAndSaveAs("compressed.pdf", 40); 這將載入PDF，以40%的品質壓縮圖像，並儲存結果。
壓縮適用於由HTML建立的PDF嗎？
是的，IronPDF的壓縮適用於通過多種方法建立的PDF，包括HTML字串轉PDF、URL轉PDF和HTML文件轉換，以及現有的PDF文件。
哪些型別的內容最能從PDF壓縮中受益？
圖像通常消耗大部分PDF文件大小，使得圖像繁重的文件是壓縮的理想物件。此外，具有複雜表格結構的PDF從IronPDF的結構樹壓縮功能中受益。
我可以壓縮PDF而不將其儲存到磁碟嗎？
可以，IronPDF提供CompressPdfToBytes和CompressPdfToStream方法，它們分別將壓縮的PDF作為位元組陣列或流返回。兩者都接受一個可選的CompressionMode參數，提供自動、快速記憶體或高品質壓縮選項。
壓縮是否適用於其他語言而非C#？
是的，CompressPdfToBytes和CompressPdfToStream現已在所有IronPDF平台上可用，包括Java、Node.js和Python。
如何在C#中獲得對PDF壓縮的精細控制？
向CompressAndSaveAs傳遞一個AdvancedCompressionOptions物件來調整管道，包括透過TargetImageDpi進行圖像DPI降採樣、透過JpegQuality進行JPEG再編碼品質和zlib的CompressionLevel。原本的CompressAndSaveAs(outputPath, quality, removeStructureTree)重載仍然有效且產生與之前相同的輸出。
還在捲動嗎？
想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。
免費開始
免費開始
預訂免費直播演示
