如何避免System.Net.Mail嵌入图片同时被添加为邮件附件？

这问题我之前帮好几个开发者排查过，核心原因是你没给嵌入的Logo正确标记「处置类型」，导致邮件客户端（比如Outlook）把它当成了普通附件处理。下面给你两种靠谱的解决办法，都是基于System.Net.Mail的标准用法，选哪种都能解决问题：

方法1：用LinkedResource（推荐，专门为嵌入资源设计） #

LinkedResource是.NET里专门给HTML邮件嵌入资源（图片、样式表这类）准备的类，用它就不会出现「既嵌入又当附件」的情况。步骤很简单：

1. 创建MailMessage对象，开启HTML格式；
2. 把Logo文件转成LinkedResource，给它设置一个唯一的ContentId（这个ID要和HTML里的<img>标签对应）；
3. 创建HTML视图，把LinkedResource添加到视图的资源集合里，再把视图加到邮件里。

代码示例：

// 初始化邮件
var mail = new MailMessage("your@domain.com", "recipient@domain.com")
{
    Subject = "带嵌入Logo的测试邮件",
    IsBodyHtml = true
};

// 读取Logo并创建嵌入资源
var logoPath = @"D:\Projects\your-logo.png";
var logoResource = new LinkedResource(logoPath, MediaTypeNames.Image.Png)
{
    ContentId = "company_logo" // 这个ID要和HTML里的cid完全匹配
};

// 创建HTML内容视图
var htmlView = AlternateView.CreateAlternateViewFromString(
    "<div>欢迎访问我们的网站 <img src='cid:company_logo' alt='公司Logo'></div>",
    null,
    MediaTypeNames.Text.Html
);
htmlView.LinkedResources.Add(logoResource);

// 将视图添加到邮件
mail.AlternateViews.Add(htmlView);

// 发送邮件（这里假设你已经配置好SmtpClient）
using var smtp = new SmtpClient("smtp.your-domain.com", 587)
{
    Credentials = new NetworkCredential("your@domain.com", "your-password"),
    EnableSsl = true
};
smtp.Send(mail);

这种方式下，LinkedResource会被明确标记为「嵌入资源」，邮件客户端只会在HTML里渲染它，不会把它放到附件列表里。

方法2：如果必须用Attachment，记得设置Inline属性 #

要是你因为某些原因非得用Attachment类来添加图片，那一定要给Attachment设置两个关键属性：ContentId和ContentDisposition.Inline = true。

代码示例：

var mail = new MailMessage("your@domain.com", "recipient@domain.com")
{
    Subject = "带嵌入Logo的测试邮件",
    Body = "<div>欢迎访问我们的网站 <img src='cid:company_logo' alt='公司Logo'></div>",
    IsBodyHtml = true
};

// 创建附件并标记为内联
var logoAttachment = new Attachment(@"D:\Projects\your-logo.png", MediaTypeNames.Image.Png)
{
    ContentId = "company_logo", // 和HTML的cid对应
    ContentDisposition = { Inline = true } // 关键：告诉客户端这是内联资源，不是普通附件
};

mail.Attachments.Add(logoAttachment);

// 发送邮件（配置同上）
using var smtp = new SmtpClient("smtp.your-domain.com", 587)
{
    Credentials = new NetworkCredential("your@domain.com", "your-password"),
    EnableSsl = true
};
smtp.Send(mail);

这里一定要注意：如果没设置ContentDisposition.Inline = true，Attachment默认会被标记为「附件」，哪怕你设置了ContentId，Outlook还是会把它当成附件显示，甚至生成像ATT00001这种默认文件名。

几个容易踩的坑 #

• 确保HTML里的cid:后面的内容和代码里的ContentId完全一致，大小写最好也匹配（虽然大部分客户端不敏感，但严格匹配更稳妥）；
• 不要同时用LinkedResource和Attachment添加同一个图片，不然会出现重复内容；
• 有些旧版本的Outlook可能会在「附件」面板里显示嵌入资源的缩略图，但不会让用户下载（这是客户端的显示逻辑，不是代码问题）。

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