EPPlus中能否实现图片嵌入单元格？参考VBA的PlacePictureInCell

EPPlus支持实现类似VBA中PlacePictureInCell的图片嵌入单元格功能，通过设置图片的位置、大小匹配单元格，并配置放置属性，即可实现图片随单元格移动、调整大小的嵌入效果，而非单纯的叠加。

实现步骤与代码示例 #

以下是C#代码示例，演示如何将图片嵌入普通单元格或合并单元格：

using OfficeOpenXml;
using System.IO;

public void InsertPictureIntoCell(ExcelPackage package, string sheetName, string cellAddress, string imagePath)
{
    // 获取目标工作表
    var worksheet = package.Workbook.Worksheets[sheetName];
    var targetRange = worksheet.Cells[cellAddress];

    // 插入图片到工作表
    var picture = worksheet.Drawings.AddPicture($"EmbeddedPic_{cellAddress}", new FileInfo(imagePath));

    // 处理合并单元格：获取实际的单元格范围
    var actualRange = targetRange.Merge ? worksheet.Cells[targetRange.MergeRange.Address] : targetRange;

    // 设置图片位置与单元格对齐（EPPlus行/列索引从0开始，需转换Excel的1-based索引）
    picture.SetPosition(actualRange.Start.Row - 1, 0, actualRange.Start.Column - 1, 0);

    // 调整图片大小匹配单元格范围（保持比例可选）
    // 方式1：直接填充单元格（可能拉伸变形）
    picture.SetSize((int)actualRange.Width, (int)actualRange.Height);

    // 方式2：保持图片比例，居中显示在单元格内（推荐）
    // var scale = Math.Min(actualRange.Width / picture.Width, actualRange.Height / picture.Height);
    // picture.SetSize((int)(picture.Width * scale), (int)(picture.Height * scale));
    // picture.SetPosition(
    //     actualRange.Start.Row - 1, (int)((actualRange.Height - picture.Height) / 2),
    //     actualRange.Start.Column - 1, (int)((actualRange.Width - picture.Width) / 2)
    // );

    // 设置放置属性：随单元格移动并调整大小，对应VBA的xlMoveAndSize
    picture.Placement = ePlacement.MoveAndSize;
}

// 调用示例
public void TestPictureInsertion()
{
    using (var package = new ExcelPackage(new FileInfo(@"C:\YourExcelFile.xlsx")))
    {
        // 嵌入普通单元格
        InsertPictureIntoCell(package, "Sheet1", "A1", @"C:\Image.png");
        // 嵌入合并单元格
        InsertPictureIntoCell(package, "Sheet1", "B2:C3", @"C:\AnotherImage.png");
        
        package.Save();
    }
}

关键说明 #

• 位置匹配：SetPosition方法使用0-based的行/列索引，因此需要将Excel的1-based单元格行号/列号减1转换。
• 放置属性：设置picture.Placement = ePlacement.MoveAndSize是实现嵌入的核心，该属性让图片随单元格的移动、大小调整同步变化，与VBA中的xlMoveAndSize效果一致。
• 合并单元格处理：通过判断targetRange.Merge获取合并区域的实际范围，确保图片覆盖整个合并单元格。

内容的提问来源于stack exchange，提问作者Steve Dickson