建立可編輯文件並使用 GroupDocs.Editor .NET 管理資源

您是否在 .NET 應用程式中為高效的文件編輯和資源管理而苦惱？GroupDocs.Editor for .NET 提供了強大的解決方案，可簡化這些工作。在本教學中，您將學習如何建立可編輯文件實例、提取圖像和字型，並以高效的方式處理資源。

快速解答

• 「建立可編輯文件」是什麼意思？ 這表示將檔案載入 GroupDocs.Editor，取得可程式化修改的 EditableDocument 物件。
• 如何從 Word 檔案提取圖像？ 使用 EditableDocument.Images 集合，並對每個 IImageResource 呼叫 Save。
• 我可以從 Word 文件提取字型嗎？ 可以 — EditableDocument.Fonts 集合讓您存取所有嵌入的字型。
• 哪個關鍵字可協助我在 .NET 中編輯 Word 文件？ 主要的 API 呼叫是 editor.Edit(editOptions)。
• 正式環境需要授權嗎？ 非試用部署必須擁有有效的 GroupDocs.Editor 授權。

「建立可編輯文件」是什麼？

當您呼叫 Editor.Edit(...) 時，GroupDocs.Editor 會解析來源檔案並回傳一個 EditableDocument。此物件會公開文件的結構元素（文字、圖像、字型、CSS），讓您在儲存最終版本前讀取、修改或取代它們。

為何使用 GroupDocs.Editor 進行資源提取？

• 集中式 API — 支援 Word、PDF、Excel 與 PowerPoint 檔案。
• 高保真度 — 在保留版面配置的同時，提供對嵌入資產的低階存取。
• 效能就緒 — 您可以透過即時釋放資源來控制記憶體使用量。

前置條件

• .NET 4.6 或以上（或任何支援的 .NET Core/5+ 執行環境）
• Visual Studio 或其他 C# IDE
• 具備基本的 C# 檔案 I/O 知識（非必須，但有助於理解）

設定 GroupDocs.Editor for .NET

要開始使用 GroupDocs.Editor，請將其加入專案的相依性。以下說明如何安裝：

安裝資訊

使用 .NET CLI：

dotnet add package GroupDocs.Editor

使用套件管理員：

Install-Package GroupDocs.Editor

NuGet 套件管理員 UI：
搜尋「GroupDocs.Editor」並安裝最新版本。

取得授權步驟

• 免費試用： 先從官方網站下載免費試用版。
• 臨時授權： 申請臨時授權以解鎖全部功能。
• 購買： 若需長期使用，請考慮購買授權。

安裝完成後，使用基本設定初始化 GroupDocs.Editor：

using GroupDocs.Editor;

Editor editor = new Editor("path/to/your/document");

如何使用 GroupDocs.Editor 建立可編輯文件

以下是逐步說明，展示如何載入檔案、建立可編輯文件，並清理資源。

步驟 1：初始化編輯器

提供來源檔案的路徑，並指定所需的載入選項（例如 Word 處理）。

string inputFilePath = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual path
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());

步驟 2：建立 EditableDocument 實例

設定編輯選項 — 這裡我們要求引擎提取全部字型，當您稍後需要在其他地方替換或嵌入字型時非常有用。

WordProcessingEditOptions editOptions = new WordProcessingEditOptions { FontExtraction = FontExtractionOptions.ExtractAll };
EditableDocument beforeEdit = editor.Edit(editOptions);
beforeEdit.Dispose();
editor.Dispose();

專業提示： 在完成使用後盡快釋放 EditableDocument 與 Editor，以降低記憶體使用量。

資源提取與資訊顯示

現在您已有可編輯文件，可提取圖像、字型與樣式表。

步驟 3：收集資源

List<IImageResource> images = beforeEdit.Images;
List<FontResourceBase> fonts = beforeEdit.Fonts;
List<CssText> stylesheets = beforeEdit.Css;

步驟 4：儲存提取的資源

以下迴圈會將每個資源寫入您指定的資料夾，方便建立媒體庫或進一步分析。

string outputFolderPath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "Resources");
Directory.CreateDirectory(outputFolderPath);

foreach (var image in images)
{
    string imagePath = Path.Combine(outputFolderPath, image.FilenameWithExtension);
    image.Save(imagePath);
}

foreach (var font in fonts)
{
    string fontPath = Path.Combine(outputFolderPath, font.FilenameWithExtension);
    font.Save(fontPath);
}

foreach (var stylesheet in stylesheets)
{
    string stylesheetPath = Path.Combine(outputFolderPath, stylesheet.FilenameWithExtension);
    stylesheet.Save(stylesheetPath);
}

直接存取資源內容

有時您需要原始位元組或 Base64 字串（例如在 HTML 電子郵件中嵌入圖像）。

步驟 5：取得位元組流與 Base64 字串

Stream imageStream = images[0].ByteContent; // Get byte stream of the first image
string base64EncodedResource = images[0].TextContent; // Get base64 string of the first image

實務應用

GroupDocs.Editor .NET 可整合至各種系統，提升文件管理工作流程：

1. 自動化文件處理 — 大量處理合約、提取簽名並重新格式化內容。
2. 自訂報告產生 — 以程式方式替換模板中的佔位符。
3. 內容管理系統 (CMS) — 提取嵌入的媒體，以在網頁間重複使用。

效能考量

• 提前釋放： 完成後立即呼叫 Dispose() 釋放 EditableDocument 與 Editor。
• 非同步選項： 盡可能在背景執行緒中執行提取，以保持 UI 響應。
• 字型提取調整： 若不需要全部字型，將 FontExtraction 設為 ExtractUsedOnly 以減少記憶體開銷。

常見問題與技巧

常見問答

Q: GroupDocs.Editor 是否相容所有 .NET 版本？
A: 是的，它支援 .NET Framework 4.6+ 以及更新的 .NET Core/5/6 執行環境。

Q: 我可以從非 Word 文件提取資源嗎？
A: GroupDocs.Editor 支援 PDF、試算表與簡報，因此也能從這些格式提取圖像、字型與 CSS。

Q: 如何有效處理大型檔案？
A: 使用非同步方法、以串流方式處理資源，並在完成後立即釋放物件。

Q: GroupDocs.Editor 的授權選項有哪些？
A: 您可以先使用免費試用、取得臨時授權以評估，或購買完整的商業授權以供正式使用。

Q: 我可以進一步自訂編輯體驗嗎？
A: 當然可以。API 提供廣泛的選項，如自訂 CSS 注入、字型替換與版面調整。

資源

• 文件說明
• API 參考文件
• 下載
• 免費試用
• 臨時授權
• 支援論壇

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