1. IronWord
  2. 操作指南
  3. 添加图像

如何在 C# 中向 DOCX 添加图像

Ahmad Sohail
Ahmad Sohail
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

图片可以为现有的 Word 文档添加视觉背景。 用来描述一个句子、一段文字或一段纯文本。 使用 IronWord（一个用于处理 DOCX 文件的 C# 库），在 Word 文档 (.docx) 中添加图片变得非常简单。 本指南将介绍在 .NET 环境中为 .docx 文件添加图片的必要步骤。

试用 IronWord

今天在您的项目中使用 IronWord，免费试用。

第一步：
green arrow pointer

如何在 DOCX 中添加图片

  1. 下载并安装最新稳定版 IronWord
  2. 初始化一个新的 Word 文档
  3. 定义图像对象（.bmp、.jpg、.png 或其他支持的格式）
  4. 将图片添加到文档中
  5. 保存文档文件

添加图片

通过程序，可以使用本地系统中定义的路径来引用图像。 首先，通过提供字符串形式的文件路径来实例化ImageContent类。 然后，可以在文件的各个位置使用image变量，或者只是修改其属性，例如宽度、高度。 最后，使用AddImage()函数将图像添加到 .docx 文件中。 添加完成后，文档可以导出并保存到本地。 在下面的示例中，我们将图像添加到文档中，而没有添加任何父节点。 支持的文件格式有：.jpg、.png、.bmp、.tiff、.gif。

提示可将图片作为子元素插入段落中，以改善文档层次结构。 该段还可以定义文本换行和其他文本格式属性。

:path=/static-assets/word/content-code-examples/how-to/add-image-insert-image.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.jpg");

// modifying image properties
image.Width = 200;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("inserted-image.docx");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
添加图像

通过流添加图像

使用前面提到的方法，可以很轻松地将本地提供的图片或通过静态 URL 提供的图片直接添加到 .docx 文件中。 要添加位于安全 API 之后、需要身份验证的图像， Stream方法比较合适。 在下面的示例中，HTTP 客户端向服务器发送授权令牌，验证后检索经过身份验证的图像流，并在导出最终的 .docx 文件之前直接将其集成。

:path=/static-assets/word/content-code-examples/how-to/add-image-insert-image-via-http-stream.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

using (HttpClient client = new HttpClient())
{
    // Add authentication headers
    client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY_HERE");
    client.DefaultRequestHeaders.Add("User-Agent", "MyApp/1.0");

    // Get image from authenticated endpoint
    Stream authenticatedStream = client.GetStreamAsync("https://api.example.com/secure/image.png");
    doc.AddImage(authenticatedStream);
}

// Export docx
doc.SaveAs("added-image-via-http-stream.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

修改图像属性

IronWord 为图像提供了默认的自定义方法。

设置 说明 范例
Width 图片的水平尺寸（像素 image.Width = 500;
Height 图片的垂直尺寸（像素 image.Height = 300;
WrapText 图像周围的文字包装行为 image.WrapText = WrapText.Square;
DistanceFromLeft 从左边缘开始的间距测量，单位为像素 image.DistanceFromLeft = 10;
DistanceFromRight 以像素为单位从右边开始测量间距 image.DistanceFromRight = 10;
DistanceFromTop 从上边缘开始的间距测量，单位为像素 image.DistanceFromTop = 15;
DistanceFromBottom 以像素为单位从底边开始测量间距 image.DistanceFromBottom = 15;
Position 空间位置信息（X 和 Y 坐标） image.Position = new ElementPosition(50, 100);
Scale X 轴和 Y 轴的比例大小系数 image.Scale = new PointF(1.5f, 1.5f);
Translate 用于重新定位的位移坐标 image.Translate = new PointF(20, 30);

自定义宽度和高度

可以通过改变预定义的宽高比来实现自定义宽度和高度。

:path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.tiff");

// modifying the aspect ratio by introducing custom width
image.Width = 800;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("custom-size-image.docx");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
添加图片 自定义尺寸

常见问题解答

如何使用 C# 将图像添加到 DOCX 文件？

您可以通过使用 IronWord 以编程方式在 C# 中将图像添加到 DOCX 文件中。它允许您轻松操作 Word 文档，包括插入图像。

使用 IronWord 可以添加哪些类型的图像到 DOCX？

IronWord 支持各种图像格式，包括 JPEG、PNG、BMP 和 GIF，可以添加到 DOCX 文件中。

是否可以使用 IronWord 在 Word 文档中定位图像？

是的，IronWord 允许对 Word 文档中的图像定位进行精确控制，使您能够指定位置和对齐方式。

我可以使用 IronWord 向单个 Word 文档添加多个图像吗？

当然可以。IronWord 支持向单个 Word 文档添加多个图像，允许您设计复杂的文档布局。

IronWord 是否支持向页眉和页脚添加图像？

是的，IronWord 可以用于向 Word 文档的页眉和页脚添加图像，提升文档设计。

IronWord 如何处理图像缩放和调整大小？

IronWord 提供功能可以在将图像添加到 Word 文档时缩放和调整其大小，确保它们在布局中无缝契合。

我可以使用 IronWord 在 DOCX 文件中为图像添加标题吗？

是的，IronWord 允许您为图像添加标题，增强 Word 文档中的清晰度和上下文。

是否可以使用 IronWord 替换 Word 文档中的现有图像？

IronWord 使您能够替换 Word 文档中的现有图像，提供了文档更新和编辑的灵活性。

使用 IronWord 向 DOCX 文件添加图像的系统要求是什么？

IronWord 需要 .NET 框架支持，并且与 Windows、macOS 和 Linux 环境兼容以添加图像到 DOCX 文件。

我可以使用 IronWord 自动化向 DOCX 文件添加图像的过程吗？

是的，IronWord 便利了 DOCX 文件中图像添加过程的自动化，简化文档创建和编辑任务。

Ahmad Sohail
Ahmad Sohail
  立即与工程团队聊天
全栈开发者

Ahmad 是一名全栈开发人员，拥有扎实的 C#、Python 和 Web 技术基础。他对构建可扩展的软件解决方案深感兴趣，并喜欢探索设计和功能在实际应用中如何结合。

在加入 Iron Software 团队之前，Ahmad 致力于自动化项目和 API 集成，专注于提高性能和开发人员体验。

在业余时间，他喜欢尝试 UI/UX 想法，贡献开源工具，并偶尔从事技术写作和文档工作，以便让复杂主题更易于理解。

准备开始了吗？
Nuget 下载 27,129 | Version: 2025.11 刚刚发布