如何通过NetOffice.Outlook C#库区分邮件正文图片与附件图片？

你的现有代码依赖CID属性（0x3712001F）判断内嵌图片，但Exchange账户下普通附件也可能携带该属性，导致误判。以下是几种通用的检测方案：

方案1：结合CID与HTML正文引用验证 #

内嵌图片在HTML格式的邮件中，一定会通过cid:[CID值]的形式被正文引用。我们可以同时检查CID是否存在，以及该CID是否出现在邮件的HTMLBody中：

改进后的检测方法 #

private bool IsInlineImage(Attachment attachment, MailItem mailItem)
{
    try
    {
        var propertyAccessor = attachment.PropertyAccessor;
        // 获取附件的CID属性
        var cid = propertyAccessor.GetProperty("http://schemas.microsoft.com/mapi/proptag/0x3712001F")?.ToString();
        
        if (string.IsNullOrEmpty(cid))
            return false;
        
        // 检查CID是否在HTML正文中被引用
        if (!string.IsNullOrEmpty(mailItem.HTMLBody))
        {
            return mailItem.HTMLBody.Contains($"cid:{cid}");
        }
        
        // 纯文本/RTF邮件中，内嵌图片通常为olEmbeddeditem类型
        return attachment.Type == OlAttachmentType.olEmbeddeditem;
    }
    catch
    {
        return false;
    }
}

调用示例 #

var saveInlineImages = false;
foreach (var attachment in mailItem.Attachments)
{
    if (attachment == null) continue;
    using (attachment)
    {
        var attName = attachment.FileName;
        var savePath = GetSavePath();
        try
        {
            // 传入mailItem用于验证CID引用
            if (!saveInlineImages && IsImage(attName) && IsInlineImage(attachment, mailItem))
                continue;
            attachment.SaveAsFile(savePath);
        }
        catch
        {
            throw new Exception($"Failed to write the file: {savePath}");
        }
    }
}

方案2：补充多维度属性验证 #

除了CID和HTML引用，还可以结合以下MAPI属性增强准确性：

1. Attachment.Type：内嵌图片通常为OlAttachmentType.olEmbeddeditem
2. Attachment.Position：非内嵌附件的Position为0，内嵌图片的Position大于0
3. PR_ATTACHMENT_HIDDEN（0x7FFE000B）：隐藏属性为true的附件通常是内嵌资源

整合后的检测方法 #

private bool IsInlineImage(Attachment attachment, MailItem mailItem)
{
    try
    {
        var propertyAccessor = attachment.PropertyAccessor;
        
        // 1. 检查是否为内嵌对象类型
        if (attachment.Type == OlAttachmentType.olEmbeddeditem)
            return true;
        
        // 2. 检查Position属性，非0表示在正文中有占位位置
        if (attachment.Position > 0)
            return true;
        
        // 3. 检查附件是否为隐藏状态
        var isHidden = (bool?)propertyAccessor.GetProperty("http://schemas.microsoft.com/mapi/proptag/0x7FFE000B") ?? false;
        if (isHidden)
            return true;
        
        // 4. 检查CID是否存在且被HTML正文引用
        var cid = propertyAccessor.GetProperty("http://schemas.microsoft.com/mapi/proptag/0x3712001F")?.ToString();
        if (!string.IsNullOrEmpty(cid) && !string.IsNullOrEmpty(mailItem.HTMLBody))
        {
            return mailItem.HTMLBody.Contains($"cid:{cid}");
        }
        
        return false;
    }
    catch
    {
        return false;
    }
}

注意事项 #

• HTML格式邮件：优先通过cid:引用验证，这是最可靠的判断方式
• 纯文本/RTF格式邮件：依赖Attachment.Type和Position属性判断
• Exchange账户场景：普通附件可能携带CID，但不会被HTML正文引用，通过结合验证可避免误判

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