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

IronWord 提供 ImageContent 類別，可將圖片 (.jpg、.png、.bmp、.tiff、.gif) 插入 DOCX 檔案，並可自訂寬度、高度和文字包覆等屬性。 使用 IronWord 在 Word 文件中添加圖片，以實現文件自動化和報告生成。

快速入門：在 C# 中為 DOCX 添加圖片。

1.透過 NuGet 套件管理員安裝 IronWord 2.建立新的 WordDocument 範例 3.使用 ImageContent 類載入您的圖片 4.使用 AddImage() 將圖片加入文件中 5.將檔案儲存為 DOCX

試試IronWord

!{--01001100010010010100001001010010010000010101001001011001010111110101001101010100010001010101010 10100010111110101010001010010010010010100000101001100010111110100001001001100010011111010000100100110001001111010101

如何在 DOCX 中加入圖片？ 使用檔案路徑參考圖片。 首先，以檔案路徑為字串實體化 `ImageContent` 類。 在整個檔案中使用 `image` 變數來修改寬度和高度等屬性。 使用 `AddImage()` 函式將影像新增至 .docx 檔案。 將文件匯出並儲存在本機。 下面的範例在沒有任何父節點的情況下，將圖片加入文件中。 支援的檔案格式包括 .jpg、.png、.bmp、.tiff 及 .gif。 這種靈活性讓您可以使用任何常見的圖像格式。

提示Insert an image as a child element within a paragraph for better document hierarchy. 段落定義文字包裝和其他文字格式屬性。 這種方法提供了更多的圖像定位控制，並允許圖像與周圍的文字流動。

```csharp :path=/static-assets/word/content-code-examples/how-to/add-image-insert-image.cs ```

支援哪些影像格式？ 支援的檔案格式：.jpg, .png, .bmp, .tiff 和 .gif。 每種格式在插入時都要保持其品質。 JPEG 最適用於照片。PNG 支援透明度，適用於標誌和圖形。 BMP 提供未壓縮的品質。 TIFF 適合高品質的列印文件。 GIF 允許簡單的動畫（在靜態文件中只顯示第一幀）。

圖片在文件中的位置？ 預設會在目前游標位置新增圖片，不含任何父節點。 為了精確定位，請在段落中插入圖片作為子元素。這樣可以更好地控制文字流程，並將圖片與您的文件結構整合在一起。

為何使用 ImageContent 類別？ ImageContent 類以結構化的方式管理影像屬性。 插入前修改尺寸、定位和格式。 此方法可確保文件生成流程的一致性，並在整個應用程式中應用標準格式規則。 該類型封裝了所有與影像相關的屬性，使程式碼更易於維護，並減少格式錯誤。

如何透過 Stream 新增圖片？ 使用前述方法可輕鬆新增本地或靜態 URL 圖片。 然而，應用程式通常會使用資料庫、Web 服務或動態產生內容的影像。 使用 `Stream` 方法在需要驗證的安全 API 後面加入圖片。 以下範例顯示 HTTP 用戶端傳送授權標記以擷取已驗證的影像串流。 在匯出前，資料流會直接整合到文件中。 此方法可消除暫存檔案，並提高敏感影像資料的安全性。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-image-insert-image-via-http-stream.cs ```

何時應該使用 Stream 方法？ 使用 `Stream` 方法時： - 圖片位於需要驗證的安全 API 之後 - 從記憶體動態處理影像 - 處理資料庫中儲存為二進位資料的影像 此方法適用於企業應用程式，在這些應用程式中，影像儲存在文件管理系統、雲端儲存或由影像處理服務所產生。

Stream Loading 有哪些優點？ 串流載入可整合來自驗證端點的影像，而無需儲存臨時檔案。 這可提高安全性和效能。 福利包括： - 減少磁碟 I/O 作業 - 磁碟上沒有敏感的影像快取 - 即時影像處理工作流程 - 針對大型影像提供更好的記憶體管理 - 靈活的圖片來源選項

如何修改圖片屬性？ <！--說明：說明程式碼概念的圖表或截圖 --> IronWord 提供自訂影像屬性的全面方法。 在將影像加入文件之前或之後，調整這些屬性。

設定	描述	例子
Width	影像的水平尺寸（以像素為單位）	image.Width=500;。
Height	影像的垂直尺寸（以像素為單位）	image.Height=300;。
WrapText	圖片周圍的文字環繞行為	image.WrapText=WrapText.Square;。
距離左側	從左邊緣到間距的測量值（以像素為單位）	image.距離左側=10;。
距離	從右邊緣測量間距（以像素為單位）	image.距離=10;。
距離頁首	從頂部邊緣測量間距（以像素為單位）	image.距離頁首=15;。
距離底部	從底部邊緣測量間距（以像素為單位）	image.距離底部=15;。
位置	空間位置資訊（X 和 Y 座標）	image.位置 = new Element位置(50, 100);
規模	X軸和Y軸的比例尺寸因子	image.規模 = new PointF(1.5f, 1.5f);
翻譯	用於重新定位的位移座標	image.翻譯 = new PointF(20, 30);

如何自訂寬度與高度？ 透過改變寬高比來實現自訂寬度與高度。 控制圖片在文件中的顯示方式，無論是維持比例或符合特定的版面限制。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs ```

寬高比會發生什麼變化？ 自訂的寬度與高度值會覆蓋原始的寬高比。 拉伸或壓縮圖片以符合版面需求，例如標題、側邊欄或固定大小的容器。 極度失真會顯得不專業。 為了在調整大小時維持長寬比，請根據您的目標尺寸計算比例尺寸。

我應該先設定哪些屬性？ 依此順序設定屬性： 1.尺寸 (寬/高) - 影像排版的基礎 2.定位 (DistanceFrom 屬性) - 控制間距和邊距 3.進階屬性 (縮放/翻譯) - 微調 此方法可確保每項屬性都能順理成章地建立在先前屬性的基礎上。 某些屬性會互動 - 文字包裝會影響距離屬性的運作方式。 <！--工作後加入陰影造型-->。