关于EWS Managed API 2发送邮件时编码设置的技术咨询

嘿，这个问题我之前也折腾过，EWS Managed API确实不像SmtpClient那样给了直接设置编码的属性，但咱们可以通过两种思路搞定UTF-8编码的需求，分主题和正文来细说：

一、邮件主题的UTF-8编码设置 #

其实EWS在处理邮件主题时，默认就会用UTF-8编码（通过MIME标准的encoded-word格式），完全不用手动额外配置。比如你直接给EmailMessage.Subject赋值带中文或特殊字符的字符串：

emailMessage.Subject = "测试主题：包含中文&@#$特殊字符";

EWS会自动把它转换成类似=?utf-8?B?5rWL6K+V5LiN6K+t77yM5Y+W5a+G5Lit5paHJiNAIyQl54Wn5a2X5bm0?=的UTF-8编码主题，收件端会正常解析显示。

如果非要手动控制主题的编码格式（一般没必要），你也可以自己构造符合encoded-word规范的字符串赋值给Subject，比如：

emailMessage.Subject = "=?utf-8?B?" + Convert.ToBase64String(Encoding.UTF8.GetBytes("手动编码的中文主题")) + "?=";

但除非有特殊定制需求，否则API自动处理的方式足够靠谱。

二、邮件正文的UTF-8编码设置 #

这里分两种场景，看你需要哪种控制程度：

场景1：用API自带的Body属性（推荐） #

EWS的EmailMessage.Body属性默认就会用UTF-8编码，你只需要指定正文类型（HTML或纯文本）并赋值内容即可：

// HTML正文
emailMessage.Body = new MessageBody(BodyType.HTML, "<h1>这是UTF-8编码的中文HTML正文</h1><p>包含特殊字符：@#$%^&*</p>");

// 纯文本正文
emailMessage.Body = new MessageBody(BodyType.Text, "这是UTF-8编码的纯文本正文，包含中文和特殊字符");

API会自动帮你处理编码，生成符合UTF-8规范的MIME内容，完全不用额外设置编码参数。

场景2：用MimeContent属性完全控制MIME结构（适合复杂定制） #

如果你需要完全自定义邮件的MIME结构（比如带多部分内容、自定义头信息等），确实可以通过MimeContent属性来实现，这时候不需要设置EmailMessage.Body属性，因为MimeContent会覆盖所有邮件内容。

你需要自己构造完整的符合MIME规范的邮件内容，其中明确指定正文的charset为utf-8，主题也用UTF-8的encoded-word格式。示例代码如下：

// 构造完整的MIME邮件内容，注意换行要用\r\n
string fullMimeContent = @"From: test-sender@example.com
To: test-recipient@example.com
Subject: =?utf-8?B?5rWL6K+V5LiN6K+t?=
Content-Type: text/html; charset=utf-8
Content-Transfer-Encoding: base64

" + Convert.ToBase64String(Encoding.UTF8.GetBytes("<h1>自定义MIME的中文正文</h1>"));

// 设置MimeContent
emailMessage.MimeContent = new MimeContent("utf-8", Encoding.UTF8.GetBytes(fullMimeContent));

这里要注意：MIME内容的格式必须严格符合规范，比如每个头信息之间用\r\n分隔，正文和头信息之间要空一行，否则可能导致邮件显示异常。

总结 #

• 主题：直接赋值字符串，EWS自动处理UTF-8编码，无需额外操作；
• 正文：优先用Body属性，简单省心；如果需要完全定制MIME结构，再用MimeContent，但要自己构造符合规范的MIME内容。

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