如何在 .NET 中移除 PDF 註解並產生縮圖

介紹

如果您需要在為文件檢視器、檔案總管或內容管理系統產生縮圖的同時 移除 PDF 註解，您來對地方了。許多 .NET 開發者在產生隱藏使用者備註與標註的乾淨預覽時會遇到困難。在本教學中，我們將逐步說明如何使用 GroupDocs.Annotation for .NET 建立無註解的 PDF 縮圖。您將學會如何隱藏標註、設定輸出格式，並產生專業外觀的影像，完美適用於相簿、儀表板或任何需要無雜訊快照的 UI。

快速回答

  • 哪個函式庫可建立無註解的縮圖？ GroupDocs.Annotation for .NET
  • 哪個屬性可停用註解？ RenderComments = false
  • 我可以選擇影像格式嗎？ 可以 – 透過 PreviewFormat 支援 PNG、JPEG、BMP 等
  • 生產環境需要授權嗎？ 需要商業授權；測試時可使用臨時授權
  • 它只支援 .NET 嗎？ 同時支援 .NET Framework、.NET Core 以及 .NET 5/6+

什麼是無註解的縮圖產生？

無註解的縮圖產生指的是在渲染每一頁的視覺快照時，不包含 任何標記、備註或協作註解。最終得到的是一張乾淨、靜態的影像，完整呈現文件的實際內容——非常適合公開入口網站、法律檔案庫，或任何需要隱藏內部備註的情境。

為什麼在建立預覽時要隱藏註解？

隱藏註解可讓預覽更專業、安全且快速。減少圖層渲染可縮短處理時間，保護敏感備註，同時確保縮圖與最終列印或匯出的版本保持一致，皆不含註解。

  • 專業外觀： 最終使用者只看到文件內容，無審閱對話。
  • 安全與隱私： 敏感註解保留在內部。
  • 效能： 渲染較少圖層可加速影像產生。
  • 一致性： 縮圖與列印或匯出版本保持相同，皆不含註解。

前置條件

1. 安裝 GroupDocs.Annotation for .NET

從官方發行頁面 official distribution page 取得套件，或透過 NuGet 安裝。請確保您的專案目標為受支援的 .NET 版本。

2. 取得授權

生產環境必須使用商業授權。可於 purchase page 購買，或申請臨時評估授權 temporary evaluation license page。

3. .NET 知識

您應熟悉 C# 基礎、檔案 I/O，以及使用 using 陳述式管理資源。

匯入命名空間

using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using GroupDocs.Annotation.Options;

步驟指南：產生乾淨的文件預覽

步驟 1：初始化 Annotator

Annotator 是 GroupDocs.Annotation 用於載入與處理文件的主要入口點。
Annotator 物件會載入來源檔案。using 區塊確保在完成後釋放所有非受控資源。

using (Annotator annotator = new Annotator("annotated.pdf"_DOCX))
{

步驟 2：設定預覽選項

PreviewOptions 定義每一頁的渲染方式，包括格式、DPI 與輸出串流。
此處告訴函式庫每頁影像的儲存位置。lambda 取得頁碼並回傳可寫入的 FileStream。

    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = $"result{pageNumber}.png";
        return File.Create(pagePath);
    });

步驟 3：選擇格式與頁面

PNG 可產生清晰的縮圖，但若檔案大小較為重要，可改用 JPEG。選擇部份頁面可減少處理時間——非常適合只需要前幾頁的縮圖相簿。

    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2, 3, 4, 5, 6 };

步驟 4：停用註解渲染

RenderComments 是一個布林旗標，告訴渲染器是否在輸出中包含註解層。
此行是「如何隱藏註解」的關鍵。 將 RenderComments 設為 false 即可去除所有註解層，產生乾淨的 PDF 預覽。

    previewOptions.RenderComments = false;

步驟 5：產生預覽圖片

函式庫會處理文件，並將影像寫入先前定義的位置。

    annotator.Document.GeneratePreview(previewOptions);
}

文件預覽產生的最佳實踐

  • 縮圖尺寸調整： 產生 PNG 後，建議將其調整至約 200 × 300 px，以加快 UI 載入。
  • 分批處理大型檔案： 先產生前幾頁，之後視需求再產生其餘頁面。
  • 始終使用 using： 確保正確釋放記憶體，特別是處理大量文件時。
  • 加入錯誤處理： 捕捉 FileNotFoundException、InvalidOperationException 與授權錯誤，提升應用程式的穩定性。

常見問題與故障排除

  • 沒有產生影像： 確認輸出資料夾已存在且應用程式具有寫入權限。
  • 縮圖模糊： 嘗試提升 DPI，例如設定 previewOptions.Dpi = 150;（此行未顯示於程式碼區塊中，以保持原始區塊完整）。
  • 大型 PDF 記憶體不足： 每次處理單一頁面，或在背景工作者中使用非同步 API。
  • 找不到授權： 確保在建立 Annotator 前已載入 License 物件。

效能最佳化技巧

  • 批次處理多個文件： 迭代集合時，盡可能重複使用單一 Annotator 實例。
  • 非同步產生： 將預覽建立交由背景服務，以保持 UI 響應。
  • 快取結果： 將產生的縮圖存放於 CDN 或本機快取，避免重複處理相同檔案。
  • 選擇合適格式： PNG 提供無損品質，JPEG 在文件含大量影像時可減少檔案大小。

支援的文件格式

GroupDocs.Annotation for .NET 支援 30+ 輸入與輸出格式，讓您能為 PDF、Office 檔案、影像與 OpenDocument 標準產生預覽。

  • PDF – 最常見的使用情境。
  • Microsoft Office – DOCX、XLSX、PPTX 以及其舊版相容檔案。
  • 影像 – TIFF、JPEG、PNG、BMP（適用於掃描文件）。
  • OpenDocument – ODT、ODS、ODP 以及其他開放標準。

何時使用無註解的預覽產生

無註解的預覽產生特別適用於內部審閱備註必須隱藏的公開入口網站、顯示乾淨縮圖格的檔案瀏覽器、需要在列印前顯示最終外觀的列印工作流程，以及在品質檢查時需要比較有無註解版本的情境。

結論

現在您已掌握 如何在 .NET 中移除 PDF 註解並產生縮圖，只要將 RenderComments = false 即可取得乾淨、專業的 PDF 預覽，完美嵌入任何 UI。請依需求調整預覽格式、頁面選擇與影像尺寸，並務必妥善處理授權與錯誤情況。透過這些步驟，您的應用程式將提供快速、無雜訊的文件縮圖，提升使用者體驗。

常見問答

Q: GroupDocs.Annotation for .NET 是否相容所有文件格式？
A: 是的。它支援 PDF、DOCX、PPTX、XLSX、常見影像類型，以及多種 OpenDocument 格式。

Q: 我可以自訂產生的預覽外觀嗎？
A: 當然可以。您可以變更 PreviewFormat、設定影像尺寸、DPI，並選擇特定頁面渲染。

Q: 此函式庫支援多使用者協作嗎？
A: GroupDocs.Annotation 提供協作標註功能。預覽產生可用於建立隱藏所有使用者註解的乾淨視圖。

Q: 若遇到問題，我該向哪裡尋求協助？
A: 社群與支援團隊活躍於 support forum，您可在此提問並分享使用經驗。

Q: 有提供免費試用嗎？
A: 有，您可以下載完整功能的 full‑function trial download，在購買前測試預覽產生功能。

最後更新： 2026-09-20
測試於： GroupDocs.Annotation for .NET（最新發行版）
作者： GroupDocs

相關教學