1. IronWord
  2. 操作指南
  3. 新增圖片

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

艾哈邁德·索海爾
艾哈邁德·索海爾
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

圖片可以為現有的 Word 文件添加視覺背景。 用來描述一個句子、一段文字或一段純文字。 使用 IronWord（用於處理 DOCX 檔案的 AC# 程式庫）可以輕鬆地在 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
[17] 添加圖像

透過串流添加圖像

使用前面提到的方法，可以輕鬆地將本機提供的圖片或透過靜態 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 是一位全端開發人員，精通 C#、Python 和 Web 技術。他對建立可擴展的軟體解決方案有著濃厚的興趣，並樂於探索如何在實際應用中實現設計與功能的完美結合。

在加入 Iron Software 團隊之前，Ahmad 曾從事自動化專案和 API 整合工作，專注於提高效能和開發者體驗。

在空閒時間，他喜歡嘗試 UI/UX 設計理念，為開源工具做出貢獻，偶爾還會涉足技術寫作和文件編寫，使複雜的主題更容易理解。

準備好開始了嗎？
Nuget 下載 27,129 | Version: 2025.11 剛發表