1. IronXL
  2. 操作指南
  3. 新增、擷取及移除圖片
如何在試算表中新增、擷取及移除圖片 | IronXL

如何使用 C# 在 Excel 中新增、擷取及移除圖片

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronXL 讓 C# 開發人員能夠透過程式化方式將圖片插入 Excel 試算表、擷取現有圖片及其屬性，並使用簡單的 API 方法移除不需要的圖片，且無需依賴 Excel Interop。 當在 .NET 環境中建立需要公司標誌、產品圖片或資料視覺化圖表等視覺元素的 Excel 檔案時，此功能至關重要。

添加圖片可透過相關圖表或插圖豐富內容。 移除圖片可簡化內容編輯與組織工作。 提取圖片可讓您將其重新用於其他文件或應用程式，並更新現有的圖片。 這些功能可讓您完全掌控 Excel 工作簿內的影像處理。

快速入門：一次完成圖片插入、擷取與移除 using IronXL 直觀的 API，只需幾行程式碼即可在試算表中新增、取得及刪除圖片。 此範例展示如何插入圖片、透過 Images 集合存取該圖片，以及移除圖片——所有操作皆無需使用 Interop。

  1. using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronXL.Excel

    PM > Install-Package IronXL.Excel

  2. 請複製並執行此程式碼片段。

    workSheet.InsertImage("logo.png", 1, 1, 3, 3);
workSheet.RemoveImage(1);
var firstImage = workSheet.Images[0];

  3. 部署至您的生產環境進行測試

    立即透過免費試用，在您的專案中開始使用 IronXL

    arrow pointer

簡化工作流程（5 個步驟）

  1. 下載 C# 函式庫，用於在試算表中插入、擷取及移除圖片
  2. 匯入現有的 Excel 檔案或建立新的檔案
  3. 請使用 InsertImage 方法將圖片插入工作表
  4. 透過存取 Images 屬性來擷取圖片及其相關資訊
  5. 將 ID 傳遞至 RemoveImage 方法以移除圖片


如何將圖片新增至 Excel 試算表？

若要將圖片插入試算表，請使用 InsertImage 方法，該方法支援多種圖片格式，包括 JPG/JPEG、BMP、PNG、GIF 及 TIFF。 此功能在您需要使用 C# 建立 Excel 圖表，並為其添加額外視覺元素時特別實用。 請指定圖片的左上角與右下角座標，以確定其尺寸，尺寸將透過減去列與行的數值來計算。

此方法的簽名需要五個參數：圖片檔案路徑，以及代表起始欄位、起始列、結束欄位和結束列的四個整數。 圖片會自動拉伸或壓縮，以適應定義的儲存格範圍。 例如：

  • 針對 1x1 尺寸的圖片：
    • worksheet.InsertImage("image.gif", 5, 1, 6, 2);
  • 針對 2x2 尺寸的圖片：
    • worksheet.InsertImage("image.gif", 5, 1, 7, 3);

在 Excel 中處理圖片時，請了解 IronXL 內部如何管理這些圖片。 每張插入的圖片都會獲得一個遵循特定模式的唯一 ID。

請注意生成的圖片 ID 遵循 1、3、5、7 等奇數序列。
此奇數序列對於日後進行圖片擷取或移除操作時，引用特定圖片至關重要。

:path=/static-assets/excel/content-code-examples/how-to/add-remove-extract-worksheet-images-insert.cs
using IronXL;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Insert images
workSheet.InsertImage("ironpdf.jpg", 2, 2, 4, 4);
workSheet.InsertImage("ironpdfIcon.png", 2, 6, 4, 8);

workBook.SaveAs("insertImages.xlsx");
Imports IronXL

Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Insert images
workSheet.InsertImage("ironpdf.jpg", 2, 2, 4, 4)
workSheet.InsertImage("ironpdfIcon.png", 2, 6, 4, 8)

workBook.SaveAs("insertImages.xlsx")
$vbLabelText   $csharpLabel

InsertImage 方法可讓您在工作表中靈活調整圖片的位置與大小。 與在 Excel 中手動插入圖片不同，程式化插入能確保在多個檔案中保持一致的排版位置，因此非常適合用於生成需要標準化格式的報告或文件。 此方法在 C# 中不使用 Interop 處理 Excel 時尤為有益，因為它消除了對 Microsoft Office 安裝的依賴。

插入的圖片在 Excel 中看起來是什麼樣子？

電子試算表中，C4 和 C7 儲存格已插入兩個色彩鮮豔的標誌，顯示圖片插入成功

如何從 Excel 檔案中擷取圖片？

To extract images from the selected worksheet, access the Images property, which provides a list of all images contained within the sheet. 當您需要在不使用 Interop 的情況下載入 Excel 檔案，並處理其內嵌的視覺內容時，此功能至關重要。 透過此清單，您可以執行各種操作，例如匯出、調整大小、取得位置，以及取得每張圖片的位元組資料。 圖片 ID 採用奇數編號模式，依 1、3、5、7 等序列遞增。

此擷取流程可全面存取影像屬性與資料，讓開發人員能夠：

  • 將圖片匯出為各種格式（PNG、JPEG、BMP 等）
  • 擷取圖片定位資訊以維持版面配置
  • 存取原始位元組資料以進行自訂處理或儲存
  • 無需外部影像處理函式庫，即可透過程式碼調整影像大小

此功能在不同文件格式間遷移內容，或建置需對 Excel 檔案中的視覺資產進行分類與管理的系統時，將展現無可取代的價值。 透過程式化方式擷取圖片的功能，亦能支援自動化品質控管流程，在這些流程中，圖片需依據特定業務規則進行驗證或處理。

:path=/static-assets/excel/content-code-examples/how-to/add-remove-extract-worksheet-images-extract.cs
using IronSoftware.Drawing;
using IronXL;
using IronXL.Drawing;
using System;
using System.Collections.Generic;

WorkBook workBook = WorkBook.Load("insertImages.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Retreive images
List<IronXL.Drawing.Images.IImage> images = workSheet.Images;

// Select each image
foreach (IronXL.Drawing.Images.IImage image in images)
{
    // Save the image
    AnyBitmap anyBitmap = image.ToAnyBitmap();
    anyBitmap.SaveAs($"{image.Id}.png");

    // Resize the image
    image.Resize(1,3);

    // Retrieve image position
    Position position = image.Position;
    Console.WriteLine("top row index: " + position.TopRowIndex);
    Console.WriteLine("bottom row index: " + position.BottomRowIndex);

    // Retrieve byte data
    byte[] imageByte = image.Data;
}

workBook.SaveAs("resizeImage.xlsx");
Imports IronSoftware.Drawing
Imports IronXL
Imports IronXL.Drawing
Imports System
Imports System.Collections.Generic

Private workBook As WorkBook = WorkBook.Load("insertImages.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Retreive images
Private images As List(Of IronXL.Drawing.Images.IImage) = workSheet.Images

' Select each image
For Each image As IronXL.Drawing.Images.IImage In images
	' Save the image
	Dim anyBitmap As AnyBitmap = image.ToAnyBitmap()
	anyBitmap.SaveAs($"{image.Id}.png")

	' Resize the image
	image.Resize(1,3)

	' Retrieve image position
	Dim position As Position = image.Position
	Console.WriteLine("top row index: " & position.TopRowIndex)
	Console.WriteLine("bottom row index: " & position.BottomRowIndex)

	' Retrieve byte data
	Dim imageByte() As Byte = image.Data
Next image

workBook.SaveAs("resizeImage.xlsx")
$vbLabelText   $csharpLabel
File explorer showing extracted PNG images and files in Documents/Replicate/bin/Debug/net6.0 directory

擷取的圖片

Spreadsheet showing three extracted images positioned in cells C2-E2, C5-E6, and C8-E10 with coordinate grid

圖片尺寸

如何從 Excel 試算表中移除圖片？

Following the extract images example, you can easily remove any inserted image using its corresponding index number. 將圖片的 ID 號傳遞給 RemoveImage 方法，即可將其從工作表中移除。 此操作在您需要使用 C# 編輯 Excel 檔案以清除不需要的視覺元素，或為不同受眾準備文件時特別有用。

移除流程雖然簡單，但需要理解圖片 ID 系統。 由於 IronXL 採用奇數序列（1、3、5、7...）分配 ID，在管理多張圖片時請追蹤這些 ID。 建議在您的應用程式中實作映射系統，將具意義的名稱與圖片 ID 建立關聯，以便更輕鬆地進行管理。

:path=/static-assets/excel/content-code-examples/how-to/add-remove-extract-worksheet-images-remove.cs
using IronXL;

WorkBook workBook = WorkBook.Load("insertImages.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Remove image
workSheet.RemoveImage(3);

workBook.SaveAs("removeImage.xlsx");
Imports IronXL

Private workBook As WorkBook = WorkBook.Load("insertImages.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Remove image
workSheet.RemoveImage(3)

workBook.SaveAs("removeImage.xlsx")
$vbLabelText   $csharpLabel

若涉及包含多個工作表與圖片的更複雜情境，請參閱"管理工作表"以了解圖片操作如何與工作表層級的操作相互作用。 此外，在處理受保護的 Excel 檔案時，請參閱我們的《Excel 檔案保護指南》，以了解圖片操作在密碼保護的工作簿中如何運作。

常見問題

如何使用 C# 透過程式碼將圖片新增至 Excel 試算表？

IronXL 提供 InsertImage 方法，用於將圖片新增至 Excel 試算表。只需指定圖片檔案路徑以及圖片欲顯示的儲存格範圍座標（左上角與右下角）。IronXL 支援多種圖片格式，包括 JPG/JPEG、BMP、PNG、GIF 及 TIFF。

將圖片插入 Excel 時，支援哪些圖片格式？

IronXL 支援多種圖像格式，可插入 Excel 工作表中，包括 JPG/JPEG、BMP、PNG、GIF 及 TIFF。這種靈活性讓您能夠處理商務文件和資料視覺化中常見的各種圖像類型。

如何從 Excel 試算表中擷取現有圖片？

您可以透過 IronXL 的 Images 集合屬性，從 Excel 工作表中擷取圖片。透過存取 worksheet.Images[index]，即可取得特定圖片及其屬性與元資料，讓您能在其他文件或應用程式中重新利用這些圖片。

我可以透過程式碼從 Excel 檔案中移除圖片嗎？

是的，IronXL 提供 RemoveImage 方法，可用於從工作表中刪除圖片。只需提供圖片 ID 即可移除特定圖片，讓您完全掌控圖片管理，無需使用 Excel Interop。

如何指定插入圖片的大小與位置？

using IronXL 的 InsertImage 方法時，您需指定四個座標：起始欄位、起始列、結束欄位及結束列。圖片將自動拉伸或壓縮，以適應所定義的儲存格範圍。例如，InsertImage("image.gif", 5, 1, 6, 2) 會產生 1x1 尺寸的圖片。

我需要安裝 Microsoft Excel 才能在試算表中處理圖片嗎？

不，IronXL 為獨立運作，無需依賴 Microsoft Excel 或 Excel Interop。您只需在 .NET 應用程式中使用 IronXL程式庫，即可透過程式碼對 Excel 檔案進行圖片的新增、擷取及移除。

Curtis Chau
Curtis Chau
  立即與工程團隊聯繫
技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？
Nuget 下載 2,052,917 | 版本： 2026.6 just released
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package IronXL.Excel
執行範例 觀看您的資料變成試算表。