在 Word 中嵌入 PDF(使用 GroupDocs.Merger for .NET):一步一步指南
將 PDF 嵌入 Word 檔案可讓您保留原始格式,同時讓讀者即時存取來源文件。在本教學中,您將學習如何透過使用 GroupDocs.Merger for .NET 插入 OLE(Object Linking and Embedding)物件來 embed pdf in word。我們將涵蓋從安裝函式庫到所需程式碼的全部內容,並提供故障排除技巧與實務案例。
快速回答
- 嵌入 PDF 最簡單的方法是什麼? Use
Merger.ImportDocumentwithOleWordProcessingOptions. - 哪個函式庫支援此功能? GroupDocs.Merger for .NET.
- 我需要授權嗎? A temporary license works for evaluation; a full license is required for production.
- 我可以加入其他檔案類型嗎? Yes – the same method works for DOCX, XLSX, PPTX, and more.
- 它相容 .NET Core 嗎? Fully supported on .NET Core 3.1+ and .NET 5/6/7.
什麼是 Word 中的嵌入 PDF?
在 Word 中嵌入 PDF 意味著將 PDF 作為 OLE 物件插入,使檔案以圖示或預覽的形式顯示於文件內,同時保持原始 PDF 不變。此方法保留來源 PDF 的完整版面配置、字型與圖形,讓讀者能直接從 Word 文件開啟嵌入的檔案以供參考或進一步編輯。
為何使用 OLE 物件嵌入與 GroupDocs.Merger?
GroupDocs.Merger 支援 70+ 輸入與輸出格式,且可在不將整個文件載入記憶體的情況下處理高達 500 MB 的檔案,為大型企業工作負載提供快速且記憶體效率高的操作。使用 OLE 嵌入可讓您保持原始 PDF 完整,提供可點擊的圖示以快速存取,並確保嵌入的內容可在不同裝置與平台間攜帶。
介紹
在嘗試透過嵌入 PDF 等豐富內容來提升 Word 文件時感到困擾嗎?本教學將指導您如何使用 GroupDocs.Merger for .NET,將 OLE(Object Linking and Embedding)物件(例如 PDF)插入 Microsoft Word 文件的特定頁面。
嵌入物件可為文件增添動態或外部內容,保持互動性。無論是製作需要嵌入資料集的報告,或是需要補充檔案的簡報,此功能都能簡化流程。
您將學習
- 如何設定與使用 GroupDocs.Merger for .NET
- 一步一步的 OLE 物件嵌入至 Word 文件指南
- 關鍵設定選項與故障排除技巧
前置條件
在實作此功能之前,請確保您的開發環境已具備必要的函式庫與設定:
必要函式庫
- GroupDocs.Merger for .NET – 用於操作文件格式的強大函式庫。
- .NET Framework 或 .NET Core/5+ – 支援任何近期版本。
環境設定
- Visual Studio(2017 或更新版本)搭配 C# 支援
- 具備 .NET 中檔案處理與物件操作的基本概念
知識前提
- 熟悉 C# 程式語言
- 了解如何在 .NET 中使用外部函式庫
設定 GroupDocs.Merger for .NET
要開始使用,您需要安裝 GroupDocs.Merger。以下是步驟:
安裝
使用 .NET CLI:
dotnet add package GroupDocs.Merger
使用 Package Manager Console:
Install-Package GroupDocs.Merger
NuGet 套件管理員 UI:
搜尋 “GroupDocs.Merger” 並安裝最新版本。
取得授權
To use GroupDocs.Merger, you can acquire a license through:
- Free trial – 以暫時授權開始評估功能。
- Temporary license – 從 here 取得。
- Purchase – 在 GroupDocs Purchase 購買完整授權以供正式使用。
基本初始化
安裝完成後,於 C# 專案中匯入函式庫:
using GroupDocs.Merger;
實作指南
現在您已完成所有設定,讓我們實作嵌入 OLE 物件的功能。
如何使用 GroupDocs.Merger for .NET 在 Word 中嵌入 PDF?
使用 new Merger("source.docx") 載入來源 Word 檔案,設定 OleWordProcessingOptions 以指定 PDF 路徑、尺寸與頁面位置,然後呼叫 ImportDocument 與 Save。此三步流程可在一行程式碼中將 PDF 嵌入為 OLE 物件,並將結果寫入輸出路徑。
將 OLE 物件匯入 Word 文件
Merger 類別是 GroupDocs.Merger 用於操作文件的核心引擎。它提供合併、分割以及將外部檔案匯入為 OLE 物件的方法。
步驟 1:準備檔案路徑並初始化選項
OleWordProcessingOptions 定義 OLE 物件的設定,如檔案路徑、圖示大小與插入位置。先設定來源 Word 文件、欲嵌入的 PDF 以及輸出檔案的路徑。接著建立 OleWordProcessingOptions 實例以設定圖示大小與頁碼。
string sourceFilePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "sample.docx");
string embeddedFilePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "embedded.pdf");
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "output_sample.docx");
int pageNumberToEmbed = 2; // Page number for the OLE object
OleWordProcessingOptions oleOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumberToEmbed)
{
Width = 300, // Set width in points
Height = 300 // Set height in points
};
步驟 2:合併並儲存文件
使用來源檔案建立 Merger 類別的實例。利用 ImportDocument 方法加入 OLE 物件,然後儲存文件。
using (Merger merger = new Merger(sourceFilePath))
{
merger.ImportDocument(oleOptions);
merger.Save(outputFilePath); // Save the output document with embedded content
}
參數與方法
- ImportDocument – 將外部檔案加入為 OLE 物件。
- Save – 將變更寫入指定路徑。
實務應用
在各種情境中嵌入 OLE 物件相當有用:
- Business reports – 嵌入財務資料集以便快速參考。
- Technical documentation – 直接在文件中加入詳細圖表或示意圖。
- Educational materials – 插入補充閱讀、測驗或實驗說明,無需離開主要講義。
效能考量
在使用 GroupDocs.Merger 時保持應用程式回應性:
- 只嵌入必要的物件以減少檔案大小。
- 優雅地處理例外,以避免文件操作時當機。
- 高效管理記憶體與資源,特別是在大型應用程式中。
結論
您已學會如何使用 GroupDocs.Merger for .NET 無縫地將 OLE 物件嵌入 Word 文件。此功能可透過直接整合各種內容,顯著提升文件的價值。
往後步驟
探索 GroupDocs.Merger 提供的其他功能,如文件分割、合併或頁面旋轉,以充分發揮此強大函式庫於您的專案中。
常見問題
Q: 我可以嵌入除 PDF 之外的其他檔案格式嗎?
A: 是的,GroupDocs.Merger 支援多種檔案類型。請參閱 documentation 以取得完整清單。
Q: 如何使用 GroupDocs.Merger 高效處理大型文件?
A: 採用記憶體效率的做法,例如分段處理與有效的例外處理。
Q: 有沒有辦法在購買前試用此函式庫?
A: 當然,您可在 here 取得暫時授權。
Q: 在 .NET Core 上使用 GroupDocs.Merger 的系統需求是什麼?
A: 確保相容 .NET Core 3.1 或更高版本。
Q: 若遇到問題,該去哪裡尋求支援?
A: 前往 GroupDocs Support Forum 尋求協助。
資源
- 文件說明: GroupDocs.Merger Docs
- API 參考: GroupDocs API Ref
- 下載 GroupDocs.Merger: Latest Release
- 購買授權: Buy Now
- 免費試用: Try It
- 暫時授權: Acquire Temporary Access
- 其他暫時授權連結: here
- 支援與社群論壇: GroupDocs Forum
最後更新: 2026-10-01
測試版本: GroupDocs.Merger 24.2 for .NET
作者: GroupDocs