使用 C# / IronWord 从 DOCX 中提取图片

IronWord 的 ExtractImages() 方法使您能够以编程方式从 Word 文档中提取所有嵌入的图像，提供对图像数据和元数据（如尺寸和格式）的访问，以便保存或处理。

as-heading:2（快速入门：用 C# 从 DOCX 中提取图像）

```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.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？

		
今天在您的项目中使用 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>

<h2>如何从 Word 文档中提取图像？

<! -- 待办事项：在此处添加图片 -->
<! -- ![提取图像示例实现图](/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 产品类似的许可模式，提供永久许可和全面的支持选项。 对于生产部署，您需要应用[许可证密钥](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 以兼容现代浏览器。 **元数据保留**：每张提取的图像都保留了重要的元数据，包括尺寸、分辨率和颜色深度。 在实施图像优化管道或在整个应用程序中保持质量标准时，这些信息将非常有价值。 对于需要持续支持和定期更新的企业应用程序，可以考虑使用[许可证扩展](https://ironsoftware.com/csharp/ppt/licensing/extensions/)，这样可以持续获得新功能和优先支持。 如果您的项目范围扩大，[升级选项](https://ironsoftware.com/csharp/ppt/licensing/upgrades/)允许无缝扩展，以覆盖更多的开发人员或部署地点。 ## 与文档工作流集成 图像提取通常是大型文档处理工作流程的一部分。 考虑这些常见的集成模式： **内容管理系统**：在文档上传过程中提取图片，以创建缩略图预览、构建图片库或填充媒体库。 提取的图像可以为搜索功能编制索引或标记文档元数据。 **文档转换管道**：将 Word 文档转换为其他格式时，可以单独处理提取的图像，以获得最佳质量。 这种分离允许针对特定格式进行优化--例如，针对网络输出和打印输出应用不同的压缩设置。 **质量保证工作流程**：通过自动提取，可对嵌入式图片进行系统审查，以确保其符合品牌准则、分辨率要求或文件大小限制。 您可以在发布前标记包含低分辨率图片或不正确格式的文档。 要了解文档处理功能的最新功能和改进，请定期查看 [产品更新日志](https://ironsoftware.com/csharp/ppt/product-updates/changelog/)。 新版本通常包括性能增强和扩展的格式支持，可使您的图像提取工作流程受益匪浅。 ## 性能考虑 在处理包含大量或高分辨率图片的文档时，请考虑以下性能优化策略： **内存管理**：分批处理图像，而不是同时将所有图像加载到内存中。 在处理大型文档或高分辨率图像时，这种方法可以防止内存耗尽。 **异步处理**：为 I/O 操作实施异步/等待模式，尤其是将提取的图像保存到磁盘或网络存储时。 这将使您的应用程序在长时间的提取操作中保持反应灵敏。 **选择性提取**：如果您只需要特定的图像，请考虑根据图像属性或文档结构实施过滤器，以避免处理不必要的内容。 强大的 API 设计可确保在不同的文档类型和图像格式中使用一致的行为，从而可以直接在您的 .NET 应用程序中构建可靠的图像提取功能。