使用 C# / IronWord 從 DOCX 中擷取影像

IronWord 的 ExtractImages() 方法可讓您以程式化的方式從 Word 文件中萃取所有內嵌的影像，提供影像資料以及尺寸和格式等元資料的存取，以便儲存或處理。

as-heading:2(Quickstart: Extract Images from DOCX in C#)

```csharp {title="Quick Image Extraction Example"} // 安裝 IronWord：安裝-套件 IronWord 使用 IronWord；

// 載入您的 Word 文件 WordDocument doc = new WordDocument("document.docx")；

// 擷取所有圖片 var images = doc.ExtractImages()；

// 以自訂命名儲存每張圖片 int imageIndex = 0； foreach (var image in images) { // 儲存為指定格式 image.SaveAs($"output-{imageIndex}.png")；

// 存取影像屬性
Console.WriteLine($"Image {imageIndex}: {image.Width}x{image.Height}")；
imageIndex++；

}

從 Word 文件中萃取影像是內容轉移、媒體管理和程式化文件處理的常見需求。 無論您是要建立內容管理系統、自動化文件工作流程，或是建立數位歸檔，IronWord 都能簡化內嵌圖片的存取，讓圖片得以儲存、重複使用，或透過尺寸和格式等屬性進行分析。

`ExtractImages()`函數提供簡單有效的方式，從文件中擷取所有圖片，並存取其元資料以進行進一步處理。 此方法會傳回一個影像物件集合，其中包含原始影像資料和有用的元資料屬性。 對於使用 [PowerPoint 簡報](https://ironsoftware.com/csharp/ppt/examples/create-empty-presentation/)的開發人員而言，其他 Iron 套件庫也有類似的功能，展現出整個產品套件一致的 API 設計。

<h3>如何開始使用 IronWord？

!{--01001100010010010100001001010010010000010101001001011001010111110101001101010100010001010101010 10100010111110101010001010010010010010100000101001100010111110100001001001100010011111010000100100110001001111010101

---

<div class="hsg-featured-snippet">
    <h2>如何從 DOCX 檔案中提取圖像</h2>
    <ol>
        <li>下載用於從 DOCX 檔案中提取圖像的 C# 庫</li>
        <li>載入現有 Word 文檔</li>
        <li>使用<code>ExtractImages</code>存取和提取映像內容</li>
        <li>將提取的映像儲存到磁碟</li>
        <li>處理或匯出影像文件</li>
    </ol>
</div>

<h2>如何從 Word 文件中萃取圖片？

<!-- TODO: 在此添加圖片 -->
<! -- ![說明 extract images 實作範例的圖表](/static-assets/images/TODO/extract-images-example-code_illustration.webp) -->
<！--說明：說明程式碼概念的圖表或截圖 -->

使用 IronWord 從 Word 文件中提取圖片非常簡單。 檔案 `embedded_images.docx` 將被用作範例檔案，其中包含 3 頁不同頁面上的 5 張圖片。 下面的程式碼片段定義了使用 `ExtractImages()` 方法進行影像擷取的核心工作流程。

在使用文件處理函式庫時，必須瞭解 [ 授權要求](https://ironsoftware.com/csharp/ppt/licensing/)，以確保您的應用程式符合使用條款。 IronWord 採用與其他 Iron 產品類似的授權模式，提供永久授權與全面的支援選項。 對於生產部署，您需要套用 [license keys](https://ironsoftware.com/csharp/ppt/get-started/license-keys/) 來移除任何水印或限制。

```csharp
:path=/static-assets/word/content-code-examples/how-to/extract-images-properties.cs

ExtractImages() 方法會返回一個可枚举的影像物件集合，每個物件都包含完整的影像資料以及元資料。 此方法允許彈性的處理工作流程 - 您可以如上圖所示將影像儲存至磁碟、轉換成不同格式或直接串流至雲端儲存服務。 該方法可處理 Word 文件中常嵌入的各種圖像格式，包括 JPEG、PNG、BMP 和 GIF。

樣本文件是什麼樣子？

我應該期待什麼樣的輸出？

擷取的圖片保留原始格式 (例如：`.jpg`、`.png` 或其他格式)，並可以適當的檔案副檔名儲存。 您可以遍歷文件中的所有圖片，或根據您的需求針對特定部分進行翻譯。 ## 進階圖像萃取情境 除了基本的擷取功能之外，IronWord 的圖像處理功能還支援開發人員在生產應用程式中經常遇到的幾種進階情境： **批量處理多個文件**：在處理大型文件集時，您可以實施平行處理，同時從多個 Word 檔案中擷取影像。 此方法可大幅縮短文件歸檔或內容遷移專案的處理時間。 **影像格式轉換**：擷取的影像物件支援格式間的轉換。 您可能會從 Word 文件中擷取 JPEG 並將其儲存為 PNG 以進行網頁最佳化，或轉換為 WebP 以與現代瀏覽器相容。 **Metadata Preservation**：每張擷取的影像都會保留重要的 metadata，包括尺寸、解析度和色彩深度。 這些資訊在實施影像最佳化管道或維護整個應用程式的品質標準時非常有價值。 對於需要持續支援和定期更新的企業應用程式，請考慮探索[授權延伸](https://ironsoftware.com/csharp/ppt/licensing/extensions/)，以提供持續存取新功能和優先支援。 如果您的專案範圍擴大，[升級選項](https://ironsoftware.com/csharp/ppt/licensing/upgrades/)可讓您無縫擴充，以涵蓋更多開發人員或部署地點。 ## 與文件工作流程整合。 影像擷取通常是大型文件處理工作流程的一部分。 考慮這些常見的整合模式： **內容管理系統**：在文件上傳時擷取圖片，以建立縮圖預覽、建立圖庫或填充媒體庫。 擷取的圖片可以為搜尋功能編製索引，或標示文件元資料。 **文件轉換管道**：將 Word 文件轉換為其他格式時，可分別處理擷取的影像，以獲得最佳品質。 這種分離允許特定格式的最佳化 - 例如，針對網頁與列印輸出應用不同的壓縮設定。 **品質保證工作流程**：自動擷取可系統性檢視內嵌圖片是否符合品牌準則、解析度要求或檔案大小限制。 您可以在出版前標示包含低解析度圖片或不正確格式的文件。 若要隨時更新文件處理功能的最新特性和改進，請定期查看 [產品更新記錄](https://ironsoftware.com/csharp/ppt/product-updates/changelog/)。 新版本通常包括效能增強和擴充的格式支援，可讓您的影像擷取工作流程獲益良多。 ## 效能考量 在處理包含大量或高解析度圖片的文件時，請考慮這些效能最佳化策略： **記憶體管理**：分批處理影像，而不是同時將所有影像載入記憶體。 在處理大型文件或高解析度影像時，此方法可避免記憶體耗盡。 **Asynchronous Processing**：為 I/O 作業實施 async/await 模式，尤其是將擷取的影像儲存至磁碟或網路儲存空間時。 這可讓您的應用程式在冗長的擷取作業中保持反應迅速。 **選擇性擷取**：如果您只需要特定的圖片，請考慮根據圖片屬性或文件結構執行篩選器，以避免處理不必要的內容。 強大的 API 設計可確保在不同的文件類型和圖像格式中都有一致的行為，讓您可以直接在 .NET 應用程式中建立可靠的圖像擷取功能。