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

IronWord 的ExtractImages()方法可讓您以程式設計方式從 Word 文件中提取所有嵌入的圖像，從而可以存取圖像資料和元資料（如尺寸和格式）以進行儲存或處理。

快速入門：使用 C# 從 DOCX 中提取圖像

```csharp {title="快速影像擷取範例"} // 安裝 IronWord：Install-Package 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($"映像 {imageIndex}: {image.Width}x{image.Height}");
imageIndex++;

}

從 Word 文件中提取影像是內容遷移、媒體管理和程式化文件處理的常見需求。 無論您是建立內容管理系統、自動化文件工作流程還是建立數位檔案，IronWord 都能簡化對嵌入式影像的訪問，讓您透過尺寸和格式等屬性來保存、重複使用或分析這些影像。

`ExtractImages()`函數提供了一種簡單且有效率的方法，可以從文件中檢索所有影像並存取其元資料以進行進一步處理。 此方法傳回一個影像物件集合，其中包含原始影像資料和有用的元資料屬性。 對於使用[PowerPoint 簡報的](https://ironsoftware.com/csharp/ppt/examples/create-empty-presentation/)開發人員來說，其他 Iron 庫中也存在類似的功能，這表示整個產品套件的 API 設計是一致的。

### 我該如何開始使用 IronWord？

---

<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>

## 如何從Word文件中提取圖片？

<!-- TODO: Add image here -->
<!-- ![Diagram illustrating extract images example implementation](/static-assets/images/TODO/extract-images-example-code_illustration.webp) -->
<!-- Description: Diagram or screenshot illustrating the code concept -->

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

使用文件處理庫時，了解[許可要求](https://ironsoftware.com/csharp/ppt/licensing/)至關重要，以確保您的應用程式符合使用條款。 IronWord 的授權模式與其他 Iron 產品類似，提供永久授權和全面的支援選項。 對於生產環境部署，您需要套用[許可證金鑰](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或其他格式），並可儲存為適當的檔案副檔名。 您可以遍歷文件中的所有影像，也可以根據您的要求選擇特定部分。