1. IronPDF
  2. 操作指南
  3. 線性化PDF

如何使用 C# 與 IronPDF 線性化 PDF。

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

線性化 PDF 可在下載時立即顯示第一頁，大幅改善大型文件的使用者體驗。 IronPDF 提供了簡單的方法，用 C# 來建立和驗證線性化 PDF，優化您的文件，以便快速進行網路檢視。

線性化 PDF，也稱為"快速 Web 檢視"或"Web 優化 PDF"，其結構經過重新組織，以適應互聯網串流播放。 這樣一來，相容的檢視器幾乎可以立即顯示文件的第一頁，遠早於整個文件下載完成的時間。

在任務關鍵型或時間敏感型應用中，此功能尤其有用。 它消除了大型文件令人沮喪的載入時間，尤其是在網路速度慢或行動網路的情況下，使用戶能夠立即與內容互動。 這有助於加快決策速度，並提高專業環境中的生產力。 當與 IronPDF 的效能最佳化功能結合時，線性化 PDF 將提供卓越的檢視體驗。

在這篇教學文章中，我們將探討 IronPDF 為開發人員提供的選項，以便將文件匯出為線性化 PDF。

快速入門：將 PDF 線性化以加快 Web 查看速度

立即開始使用 IronPDF，輕鬆實現 PDF 線性化。 這個簡單的程式碼範例說明如何使用 IronPDF 的 LinearizePdf 方法優化 PDF，使其在網頁瀏覽器中的載入速度更快。 透過允許頁面在載入時顯示，而不是等待整個文件下載完畢，來提升使用者體驗。 請按照以下步驟簡化您的 PDF 文件，使其更適合線上分享。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案：

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

    var pdf = IronPdf.PdfDocument.FromFile("input.pdf");
pdf.SaveAsLinearized(pdf.BinaryData, "linearized.pdf");

  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF，免費試用！
    arrow pointer
### 最小工作流程（5 個步驟）
  1. 從 NuGet 下載 IronPDF C# 庫
  2. 實例化 PDF 渲染器並傳遞 HTML 字串
  3. 使用RenderHtmlAsPdf渲染 HTML 字串
  4. 使用 SaveAsLinearized 將 PDF 儲存為線性化 PDF
  5. 使用IsLinearized驗證 PDF 是否線性化。


如何將 PDF 儲存為線性化格式？

<! -- 輸出顯示 IronPDF 中的另存為線性化 pdf 結果 --> -->。 <！--說明：顯示程式碼執行輸出或結果的截圖 -->

使用 IronPDF 將文件儲存為線性化 PDF 是一個快速簡單的過程。 在開始之前，請確認您已透過 NuGet 或其他可用的安裝方式 安裝 IronPDF。

在這個範例中，我們將使用 RenderHtmlAsPdf 將 HTML 字串渲染為 PDF。 對於更複雜的 HTML 文件，您可能需要探索 IronPDF 的 HTML 至 PDF 轉換功能。 之後，我們會使用 SaveAsLinearized 實例方法，將 PdfDocument 物件儲存為線性化 PDF。 此方法接受一個字串參數，用於指定輸出檔案路徑。

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");
Imports IronPdf

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>")

' Get the PDF binary data
Dim pdfBytes = pdf.BinaryData

' Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf")
$vbLabelText   $csharpLabel

線性化流程會重整 PDF 的內部格式，將重要資訊放在檔案的開頭。這可實現循序漸進的下載和呈現，在透過 Web 應用程式提供 PDF 時尤其有利。

輸出是什麼樣子？

PDF 屬性對話方塊突顯了

如何將 PDF 位元組儲存為線性化？

除了直接保存PdfDocument物件外，IronPDF 還允許使用者將 PDF 位元組數組轉換為線性化的 PDF。 這種靈活性在處理儲存在資料庫中的 PDF 或在記憶體密集型應用程式中處理 PDF 時特別有用。 有關在記憶體中處理 PDF 的更多資訊，請參閱我們的 從記憶體流中載入 PDF 指南。

在本範例中，我們將示範如何將 HTML 字串渲染為 PdfDocument 物件，取得其位元組陣列，然後將該資料儲存為線性化 PDF。 SaveAsLinearized方法也接受一個可選的第三個字串參數，用於指定密碼（如果來源文件已加密）。

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");
Imports IronPdf

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>")

' Get the PDF binary data
Dim pdfBytes = pdf.BinaryData

' Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf")
$vbLabelText   $csharpLabel

輸出是什麼樣子？

這是程式碼產生的檔案：

如何將 MemoryStream 儲存為 Linearized？

SaveAsLinearized 方法也可以接受 Stream 物件作為輸入，為各種應用程式架構提供最大的靈活性。 在與雲端服務整合或處理臨時檔案時，此能力是不可或缺的。 進一步了解 將 PDF 匯出到記憶體 的進階方案。

在這個範例中，我們會將 PdfDocument 物件轉換為位元組陣列，寫入 MemoryStream 中，然後將串流儲存為線性化 PDF，以示範此功能。

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-stream.cs
using IronPdf;
using System.IO;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Memory Stream</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Transform PDF bytes to a MemoryStream
MemoryStream memoryStream = new MemoryStream(pdfBytes);

// Save the MemoryStream as a linearized PDF
PdfDocument.SaveAsLinearized(memoryStream, "linearize-stream.pdf");
Imports IronPdf
Imports System.IO

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Memory Stream</h1>")

' Get the PDF binary data
Dim pdfBytes As Byte() = pdf.BinaryData

' Transform PDF bytes to a MemoryStream
Dim memoryStream As New MemoryStream(pdfBytes)

' Save the MemoryStream as a linearized PDF
PdfDocument.SaveAsLinearized(memoryStream, "linearize-stream.pdf")
$vbLabelText   $csharpLabel

當您處理臨時檔案，或需要在不將中間檔案寫入磁碟的情況下處理 PDF 時，此方法尤其有用，可同時提昇效能與安全性。

這是程式碼產生的檔案：

如何驗證 PDF 是否線性化？

除了在 PDF 檢視器（如 Adobe Acrobat）中檢查文件屬性以查看 PDF 是否線性化之外，IronPDF 還提供了一種使用IsLinearized方法以程式設計方式檢查此問題的方法。 此方法接受一個字串參數作為檔案路徑，如果 PDF 檔案已加密，則也可以接受一個可選的第二個字串參數作為密碼。 此驗證能力對於品質保證非常重要，並可整合至自動化測試工作流程中。

在本範例中，我們會使用上述三個範例的輸出檔案來測試它們是否線性化，並包含第四個非線性化的 PDF 來展示該方法的行為。 如需更先進的 PDF 操作和驗證技術，請探索 IronPDF 的全面功能集。

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-test.cs
using IronPdf;
using System;

// First example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize.pdf"));

// Second example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-from-bytes.pdf"));

// Third example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-stream.pdf"));

// Fourth example Non-Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("sample.pdf"));
Imports IronPdf
Imports System

' First example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize.pdf"))

' Second example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-from-bytes.pdf"))

' Third example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-stream.pdf"))

' Fourth example Non-Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("sample.pdf"))
$vbLabelText   $csharpLabel

結果如何？

顯示 PDF 線性化結果的除錯輸出：三個 True 值和一個 False 值

如您所見，前三個範例都會回傳 true ，而最後一個 PDF 未經線性化處理，會回傳 false 。

[{i:(沒有方法可以檢查 PdfDocument 物件本身是否線性化。 這是因為當 PDF 檔案被開啟並載入到物件中時，其特殊的線性化結構會遺失。因此，目前沒有方法可以將線性化的 PDF 檔案作為位元組數組傳回。 此線性化特徵僅以儲存檔案的形式存在於磁碟上。

線性化 PDF 的最佳實務

在處理線性化 PDF 時，請考慮這些最佳實務：

1.檔案大小考量：由於格式重組，線性化可能會稍微增加檔案大小。 必要時使用 IronPDF 的壓縮功能來優化檔案大小。

2.Web 部署：線性化 PDF 是 Web 應用程式的理想選擇。 配置您的 Web 伺服器以支援 byte-range 請求，從而最大化線性化的效益。

3.效能測試：務必在您的目標環境中測試線性化 PDF。 在較慢的連線上處理大型檔案時，效能提升最為顯著。

4.相容性：雖然大多數現代 PDF 閱覽器都支援線性化 PDF，但仍要確保與您使用者偏好的閱覽器相容。

如需其他優化策略和先進的 PDF 處理技術，請參閱 IronPDF 的渲染選項說明文件。

常見問題解答

什麼是線性化 PDF，為什麼要使用它？

線性化 PDF 也稱為「Fast Web View」或「Web-optimized PDF」，是針對網際網路串流而重新組織的結構。IronPDF 的線性化功能允許相容的瀏覽器在下載其餘頁面時幾乎立即顯示第一頁，顯著改善了大型文件的用戶體驗，特別是在緩慢或移動網絡上。

如何在 C# 中建立線性化 PDF？

使用 IronPDF，您可以使用 SaveAsLinearized 方法輕鬆建立線性化 PDF。只需載入或建立您的 PDF 文件，然後調用 pdf.SaveAsLinearized(pdf.BinaryData, 'output.pdf') 將其儲存為線性化 PDF，並針對快速網頁檢視進行最佳化。

我可以將現有的 PDF 轉換成線性化格式嗎？

是的，IronPDF 允許您將現有的 PDF 轉換為線性化格式。您可以使用 PdfDocument.FromFile('input.pdf') 載入任何 PDF，然後再使用 SaveAsLinearized 方法將其儲存為線性化 PDF，以改善網頁效能。

如何驗證 PDF 是否已經線性化？

IronPDF 提供 IsLinearized 屬性來檢查 PDF 是否線性化。只需載入 PDF 文件並檢查 IsLinearized 布林屬性，即可判斷該文件是否已針對快速網頁檢視進行最佳化。

將 PDF 線性化用於 Web 應用程式的主要優點是什麼？

使用 IronPDF 對 PDF 進行線性化處理，可立即顯示第一頁，消除大型文件令人沮喪的載入時間，在專業環境中能夠更快地做出決策，並顯著改善使用者體驗，特別是在關鍵任務或時間敏感的應用程式中。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術撰稿人

Curtis Chau 擁有電腦科學學士學位（卡爾頓大學），專長於前端開發，精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情，他喜歡使用現代化的架構，並製作結構良好且視覺上吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 也有濃厚的興趣，他喜歡探索整合硬體與軟體的創新方式。在空閒時間，他喜歡玩遊戲和建立 Discord bots，將他對技術的熱愛與創意結合。

準備好開始了嗎？
Nuget 下載 17,386,124 | 版本： 2026.2 剛剛發布