"Can I load a password‑protected PDF?"

"Yes. Provide the password in `LoadOptions.Password` before calling the load method; the library will decrypt the file automatically."

"Does GroupDocs.Editor support loading documents from Azure Blob Storage?"

"Absolutely. Implement `IStorageProvider` for Azure Blob, then use `CustomStorageLoadOptions` to point to the blob URL."

"What is the maximum file size I can load?"

"The library can stream files up to **2 GB** without loading the entire content into memory, limited only by the underlying storage and .NET runtime."

"Is there a way to preview a document before fully loading it?"

"Use `Editor.GetDocumentInfo(filePath)` to retrieve metadata such as page count and format without loading the full document."

"How do I release resources after editing?"

"Wrap the `Editor` instance in a `using` block or call `Dispose()` manually; this ensures all native handles are freed promptly."

如何使用 GroupDocs.Editor for .NET 載入文件

有效載入文件是任何處理合約、報告或使用者產生內容的 .NET 應用程式的核心需求。在本指南中，您將了解 如何載入文件，包括從本機檔案系統、記憶體串流或任何自訂儲存提供者使用 GroupDocs.Editor。我們將逐一說明每種情況，解釋 API 為何如此運作，並提供實用技巧，以在支援超過 30 種不同檔案格式的同時，保持低記憶體使用量。

快速答覆

載入文件的第一步是什麼？ 使用適當的 LoadOptions 初始化 Editor 實例。
我可以直接載入 PDF 嗎？ 可以 — GroupDocs.Editor 將 PDF 視為與 Word、Excel 或 PowerPoint 檔案相同。
開發時需要授權嗎？ 臨時授權可用於測試；正式環境需要完整授權。
支援哪些 .NET 版本？ .NET Framework 4.6+、.NET Core 3.1+、.NET 5/6/7。
支援多少種格式？ 超過 30 種輸入與輸出格式，包括 DOCX、XLSX、PPTX、PDF、HTML 以及圖像類型。

什麼是 GroupDocs.Editor？

GroupDocs.Editor 是一個 .NET 函式庫，讓開發人員能夠 載入、編輯與儲存 各種文件類型，且不需在伺服器上安裝 Microsoft Office。它將檔案格式的細節抽象為統一的 API，使得在單一程式碼庫中即可輕鬆處理 Word、Excel、PowerPoint、PDF 以及其他多種格式。

為何使用 GroupDocs.Editor 載入文件？

GroupDocs.Editor 可處理 30+ 種檔案格式，且可在不將整個檔案載入記憶體的情況下處理高達 500 MB 的文件，這歸功於其串流架構。與傳統 Office 互操作方式相比，此功能可將伺服器 RAM 使用量降低最多 70 %，同時消除與 Microsoft Office 相關的授權麻煩。

先決條件

.NET Framework 4.6+ 或 .NET Core 3.1+ 執行環境已安裝。
有效的 GroupDocs.Editor for .NET 授權（評估用臨時授權）。
已在專案中加入 NuGet 套件 GroupDocs.Editor。

如何從檔案載入文件？

Editor 類別是用於載入與編輯文件的主要元件。FileLoadOptions 指定載入參數，例如開啟檔案時的格式與密碼。若要從本機路徑載入文件，請建立 Editor 實例，並傳入 FileLoadOptions 物件，若格式無法自動推斷則需明確定義。函式庫會讀取檔案標頭、驗證格式，並回傳可供編輯的 EditorDocument。

如何從串流載入文件？

Stream 是用於 I/O 操作的位元組序列表示。StreamLoadOptions 允許您提供原始檔名，以便偵測格式。若文件儲存在資料庫或雲端 Blob 中，您可以直接以 Stream 及 StreamLoadOptions 載入。此方式可避免在磁碟上產生暫存檔，提高安全性，並加速高吞吐量批次轉換的處理。

如何從自訂儲存載入文件？

IStorageProvider 是用於實作自訂儲存後端的介面。CustomStorageLoadOptions 讓您指定儲存提供者及任何必要的憑證。GroupDocs.Editor 允許您透過繼承 IStorageProvider 來插入自訂儲存實作。當您需要從 Amazon S3、Azure Blob 或本地檔案伺服器讀取，同時保持相同的載入邏輯，便可無縫整合現有雲端服務。

逐步載入指南

步驟 1：初始化 Editor

在每個應用程式生命週期中僅建立一次 Editor 物件，以重複使用內部資源。

步驟 2：選擇正確的載入選項

選取與來源類型相符的 LoadOptions：

FileLoadOptions 用於本機檔案。
StreamLoadOptions 用於串流。
CustomStorageLoadOptions 用於自訂儲存提供者。

步驟 3：呼叫 Load 方法

將來源路徑或串流與選項一起傳入。此方法會回傳可供編輯、提取文字或轉換為其他格式的 EditorDocument。

步驟 4：釋放資源

編輯完成後，呼叫 Editor 實例的 Dispose()，或將其包在 using 區塊中，以釋放非受控資源。

常見問題與解決方案

不支援的格式錯誤 — 確認檔案副檔名屬於 30+ 種支援的格式之一；若不是，請在 LoadOptions 中明確指定格式。
大型 PDF 記憶體不足 — 啟用 LoadOptions.MemoryLimit 以強制使用串流模式，將記憶體使用量控制在設定的閾值以下。
雲端儲存權限被拒 — 確認儲存提供者的憑證具備讀取權限，且 SDK 的 IStorageProvider 實作正確傳遞驗證令牌。

其他資源

常見問答

Q: 我可以載入受密碼保護的 PDF 嗎？
A: 可以。在呼叫載入方法前，於 LoadOptions.Password 提供密碼；函式庫會自動解密檔案。

Q: GroupDocs.Editor 支援從 Azure Blob Storage 載入文件嗎？
A: 當然。為 Azure Blob 實作 IStorageProvider，然後使用 CustomStorageLoadOptions 指向 Blob URL。

Q: 我能載入的最大檔案大小是多少？
A: 此函式庫可串流最高 2 GB 的檔案，而無需將全部內容載入記憶體，僅受底層儲存與 .NET 執行環境限制。

Q: 有沒有辦法在完整載入前預覽文件？
A: 使用 Editor.GetDocumentInfo(filePath) 取得如頁數與格式等中繼資料，而無需完整載入文件。

Q: 編輯完成後如何釋放資源？
A: 將 Editor 實例包在 using 區塊中或手動呼叫 Dispose()；這可確保所有原生句柄立即釋放。

最後更新： 2026-05-27
測試版本： GroupDocs.Editor 23.12 for .NET
作者： GroupDocs