如何在C# HTML格式邮件中实现Outlook式嵌入式附件？

当然可以实现！你说的这种把普通附件嵌入邮件正文的需求，其实是利用MIME协议的**内嵌附件（Inline Attachments）**机制，再结合Outlook对HTML邮件的特殊解析逻辑来达成的。这种方式能让终端用户直接在正文里看到并打开附件，不用单独去附件栏查找，非常适合大量附件的自动化邮件场景。下面给你详细讲实现步骤和注意事项：

核心原理 #

Outlook识别“正文内嵌附件”的逻辑很简单：

1. 把附件标记为内嵌（Inline），通过设置Content-Disposition: inline属性
2. 给每个附件分配一个唯一的Content-ID（CID），作为该附件在邮件中的唯一标识
3. 在HTML正文里，用<a>标签链接到这个CID（格式：href="cid:你的唯一ID"），Outlook会自动解析这个链接，让用户点击就能直接打开对应的附件

C#代码实现示例 #

我们可以用.NET自带的System.Net.Mail命名空间来快速实现，以下是完整的可运行代码：

using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Net.Mail;
using System.Net.Mime;

class InlineAttachmentEmailDemo
{
    static void Main(string[] args)
    {
        // 1. 初始化邮件基本信息
        var mail = new MailMessage(
            from: "your-sender@domain.com",
            to: "recipient@domain.com"
        );
        mail.Subject = "自动化邮件：内嵌附件测试";
        mail.IsBodyHtml = true; // 必须开启HTML正文模式

        // 2. 构建HTML正文内容
        var htmlBodyBuilder = new System.Text.StringBuilder();
        htmlBodyBuilder.Append("<h2>请查看以下内嵌附件：</h2>");
        htmlBodyBuilder.Append("<ol>");

        // 3. 准备要内嵌的文件列表（替换成你的文件路径）
        var targetFiles = new List<string>
        {
            @"D:\Reports\Q3-Sales.pdf",
            @"D:\Data\Customer-List.xlsx",
            @"D:\Docs\Project-Spec.docx"
        };

        foreach (var filePath in targetFiles)
        {
            if (!File.Exists(filePath)) continue;

            var fileName = Path.GetFileName(filePath);
            // 生成唯一的Content-ID（用GUID避免冲突，后缀保留原文件格式）
            var uniqueCid = $"{Guid.NewGuid():N}{Path.GetExtension(fileName)}";

            // 4. 创建内嵌附件并配置属性
            var attachment = new Attachment(filePath, MediaTypeNames.Application.Octet);
            // 标记为内嵌附件
            attachment.ContentDisposition.Inline = true;
            // 设置唯一Content-ID
            attachment.ContentId = uniqueCid;
            // 可选：指定文件的MIME类型，让邮件客户端更准确识别（比如PDF用application/pdf）
            // attachment.ContentType = new ContentType("application/pdf");

            // 将附件添加到邮件
            mail.Attachments.Add(attachment);

            // 5. 在HTML正文中添加指向该附件的链接
            htmlBodyBuilder.Append($"<li><a href=\"cid:{uniqueCid}\">{fileName}</a></li>");
        }

        htmlBodyBuilder.Append("</ol>");
        mail.Body = htmlBodyBuilder.ToString();

        // 6. 配置SMTP客户端并发送邮件
        using var smtpClient = new SmtpClient("smtp.your-domain.com", 587)
        {
            Credentials = new NetworkCredential("your-email-username", "your-email-password"),
            EnableSsl = true // 大多数SMTP服务器需要SSL加密
        };

        try
        {
            smtpClient.Send(mail);
            Console.WriteLine("邮件发送成功！");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"发送失败：{ex.Message}");
        }
    }
}

关键注意事项 #

• Content-ID必须唯一：一定要用GUID这类随机值生成CID，避免多个附件CID重复导致解析失败。
• Outlook兼容性：这个方案在Outlook（桌面版/网页版）中完全有效，但其他邮件客户端（如Gmail、苹果邮件）可能会将这类链接解析为普通附件，而非正文内嵌。如果你的受众主要是Outlook用户，这个方案完美适配。
• 文件类型支持：几乎所有常见文件格式（PDF、Office文档、压缩包等）都可以用这种方式内嵌，Outlook会自动调用对应程序打开。
• 区别内嵌图片：内嵌图片用<img src="cid:xxx">，而普通附件用<a href="cid:xxx">，两者都是内嵌附件的用法，只是HTML标签不同。

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