.NET MAUI应用中如何用资源图片嵌入Outlook邮件正文？

问题分析 #

本地绝对路径方案仅在调试时可行，部署后因应用沙箱机制、资源路径结构变化失效；直接读取流的方式无法被Outlook的Attachments.Add方法识别——该方法仅兼容文件路径或符合MAPI规范的流，直接传入文本内容必然报错。

正确实现步骤 #

1. 配置图片嵌入属性 #

在Visual Studio中右键Resources/Images/logo.png，修改以下属性：

• Build Action: 设置为Embedded Resource
• Copy to Output Directory: 设置为Do not copy（图片已嵌入程序集，无需额外复制）

2. 完整代码实现 #

通过读取嵌入到程序集的图片流，保存到系统临时文件后，再添加为Outlook嵌入附件：

using System.Reflection;
using System.IO;
using MsOutlook = Microsoft.Office.Interop.Outlook;

// 获取当前应用程序集
Assembly assembly = typeof(YourAppNamespace.MainPage).GetTypeInfo().Assembly;
// 资源路径格式：项目命名空间.Resources.Images.文件名（替换为你的实际命名空间）
string resourceName = "HQApp.Resources.Images.logo.png";

// 读取嵌入资源流
using Stream imageStream = assembly.GetManifestResourceStream(resourceName);
if (imageStream == null)
{
    throw new FileNotFoundException("未找到嵌入的logo资源", resourceName);
}

// 生成唯一临时文件路径，避免冲突
string tempLogoPath = Path.Combine(Path.GetTempPath(), $"temp_logo_{Guid.NewGuid()}.png");
using (FileStream tempStream = new FileStream(tempLogoPath, FileMode.Create, FileAccess.Write))
{
    await imageStream.CopyToAsync(tempStream);
}

try
{
    // 初始化Outlook应用
    MsOutlook.Application outlookAp = new MsOutlook.Application();
    if (outlookAp == null)
        return;

    MsOutlook.MailItem mail = (MsOutlook.MailItem)outlookAp.CreateItem(MsOutlook.OlItemType.olMailItem);

    // 添加嵌入附件并设置CID
    MsOutlook.Attachment logoAttacher = mail.Attachments.Add(
        tempLogoPath, 
        MsOutlook.OlAttachmentType.olEmbeddeditem, 
        null, 
        "Company Logo"
    );
    string imageCid = "companyImage";
    logoAttacher.PropertyAccessor.SetProperty(
        "http://schemas.microsoft.com/mapi/proptag/0x3712001E", 
        imageCid
    );

    // 构建包含Logo的HTML正文
    var imageBody = $"<body><img src=\"cid:{imageCid}\" width='127' height='34' alt=\"\"/></body>";
    mail.HTMLBody = imageBody + tableBody + body + mail.HTMLBody;

    // 设置邮件其他属性并发送
    mail.To = emailTo;
    mail.CC = ccTo;
    mail.Subject = subject;
    mail.Send();
}
finally
{
    // 清理临时文件（忽略删除失败的情况）
    if (File.Exists(tempLogoPath))
    {
        try { File.Delete(tempLogoPath); }
        catch { }
    }
}

3. 关键注意事项 #

• 资源路径验证：若不确定资源名称，可通过assembly.GetManifestResourceNames()打印所有嵌入资源的完整名称，确认路径正确性。
• 临时文件唯一性：用Guid.NewGuid()生成临时文件名，避免多实例运行时文件冲突。
• Outlook权限：部署时需确保应用具备访问Outlook的权限，部分环境可能需要额外权限声明。

原方案失效原因 #

• FileSystem.OpenAppPackageFileAsync：该方法要求图片Build Action为Content并复制到输出目录，但MAUI打包后（尤其是Windows App Store环境），应用运行在沙箱中，资源实际路径与调试时完全不同，导致文件找不到。
• System.Windows.Forms.Application.StartupPath：这是WinForms专属API，MAUI不推荐使用，且沙箱环境下该路径指向的位置不存在Resources/Images文件夹。

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