VSTO C# Outlook插件设置PR_HTML时Unicode字符显示异常问题

问题根源 #

PR_HTML属性要求的字节流必须让Outlook正确识别编码：

• 要么在字节流开头添加UTF-8 BOM（0xEF, 0xBB, 0xBF）
• 要么HTML内容的<head>里明确包含<meta charset="UTF-8">标签
• 最佳实践是两者同时具备，避免Outlook自动错误识别编码（比如当成ISO-8859-1）

你当前直接用UTF8Encoding.UTF8.GetBytes()得到的是无BOM的UTF-8字节，Outlook无法正确解析德语特殊字符。

修正后的实现代码 #

1. 通用编码预处理步骤

先确保HTML内容包含编码声明，再生成带BOM的UTF-8字节：

string htmlContent = originalMail.HTMLBody;

// 确保HTML头部包含UTF-8编码声明
if (!htmlContent.Contains("<meta charset=\"UTF-8\">") && !htmlContent.Contains("<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">"))
{
    int headIndex = htmlContent.IndexOf("<head>", StringComparison.OrdinalIgnoreCase);
    if (headIndex != -1)
    {
        int insertPos = headIndex + "<head>".Length;
        htmlContent = htmlContent.Insert(insertPos, "\n<meta charset=\"UTF-8\">\n");
    }
    else
    {
        htmlContent = "<!DOCTYPE html><html><head><meta charset=\"UTF-8\"></head>" + htmlContent;
    }
}

// 生成带BOM的UTF-8字节数组
byte[] utf8Bom = new byte[] { 0xEF, 0xBB, 0xBF };
byte[] htmlBytes = System.Text.Encoding.UTF8.GetBytes(htmlContent);
byte[] finalBytes = new byte[utf8Bom.Length + htmlBytes.Length];
Buffer.BlockCopy(utf8Bom, 0, finalBytes, 0, utf8Bom.Length);
Buffer.BlockCopy(htmlBytes, 0, finalBytes, utf8Bom.Length, htmlBytes.Length);

2. 修正OpenProperty方法

确保写入流的是带BOM的字节，同时修正参数传递：

Guid iidStream = typeof(Ole.IStream).GUID;
OpenProperty((uint)PropTags.PR_HTML, ref iidStream, 0, (uint)(OpenPropertyMode.MODIFY | OpenPropertyMode.CREATE), out IntPtr pObject);

if (pObject != IntPtr.Zero)
{
    Ole.IStream htmlStream = Marshal.GetObjectForIUnknown(pObject) as Ole.IStream;
    if (htmlStream != null)
    {
        Storage.Write(htmlStream, finalBytes);
        htmlStream.Commit((int)STGC.DEFAULT);
        Marshal.ReleaseComObject(htmlStream);
    }
    Marshal.Release(pObject); // 释放未托管指针
}

注意：调用时需传入正确的IID_IStream，直接用typeof(Ole.IStream).GUID更可靠。

3. 修正SetProps方法

使用带BOM的字节数组创建SBinary，确保属性标签正确：

// PR_HTML的属性标签（PT_BINARY类型）
const uint PR_HTML_TAG = 0x10130102;

pSPropValue val = new pSPropValue();
val.ulPropTag = PR_HTML_TAG;
val.Value.bin = SBinaryCreate(finalBytes); // 使用带BOM的字节数组

// 封送属性并调用SetProps
pSPropValue[] props = new pSPropValue[] { val };
IntPtr pProps = Marshal.AllocHGlobal(Marshal.SizeOf(typeof(pSPropValue)) * props.Length);
Marshal.Copy(props, 0, pProps, props.Length);

try
{
    uint[] errorIndices;
    int hr = yourIMAPIPropInstance.SetProps(1, pProps, out errorIndices);
    if (hr != 0)
    {
        // 处理错误逻辑
    }
}
finally
{
    // 释放分配的内存
    Marshal.FreeHGlobal(val.Value.bin.lpb);
    Marshal.FreeHGlobal(pProps);
}

额外注意事项 #

• 确保OOM操作和MAPI操作针对同一个邮件对象的底层属性
• 若邮件由纯文本转换而来，需确保转换过程编码不丢失
• 可通过OutlookSpy查看PR_HTML属性的原始字节，验证BOM和编码声明是否存在

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