介绍

Aspose.Email FOSS for .NET 是一个 MIT 许可证、无依赖的 C# 库，用于处理 Outlook MSG 文件、复合文件二进制（CFB）容器和 EML 消息。
本文将逐一介绍每个主要功能区域，并提供直接取自库的测试套件的可运行代码示例——此处显示的每个类名和方法签名均已针对 source repository 进行验证。

使用单个命令安装 — 无需 Microsoft Outlook、无需 COM 互操作、无需本机库：

dotnet add package Aspose.Email.Foss

关键特性

读取和检查 MSG 文件

MapiMessage.FromStream() 和 MapiMessage.FromFile() 打开任何 Outlook .msg 文件并
显示其完整内容：主题、纯文本正文、HTML 正文、发件人姓名、发件人电子邮件
地址、发送时间、互联网消息 ID、收件人以及附件。无需 Outlook
安装 — 整个 MSG 和 CFB 层在托管的 C# 中实现。

using System.IO;
using Aspose.Email.Foss.Msg;

using var stream = File.OpenRead("sample.msg");
var message = MapiMessage.FromStream(stream);

Console.WriteLine(message.Subject);
Console.WriteLine(message.SenderEmailAddress);
Console.WriteLine(message.Body);

foreach (var recipient in message.Recipients)
    Console.WriteLine($"To: {recipient.EmailAddress}");

foreach (var attachment in message.Attachments)
    Console.WriteLine($"Attachment: {attachment.Filename} ({attachment.MimeType})");

从头创建 MSG 文件

MapiMessage.Create() 在内存中构建完整的电子邮件。设置 SenderName、SenderEmailAddress、HtmlBody、InternetMessageId 和 MessageDeliveryTime 为属性后，使用 AddRecipient() 添加收件人，并使用 AddAttachment() 添加文件或流附件。使用 message.Save() 序列化 — 返回一个 byte[]，或直接写入路径或 Stream。

using System.IO;
using Aspose.Email.Foss.Msg;

var message = MapiMessage.Create("Hello", "Body");
message.SenderName = "Alice";
message.SenderEmailAddress = "alice@example.com";
message.HtmlBody = "<p>Body</p>";
message.InternetMessageId = "<hello@example.com>";
message.MessageDeliveryTime = new DateTime(2024, 1, 2, 3, 4, 5, DateTimeKind.Utc);
message.AddRecipient("bob@example.com", "Bob");
message.AddAttachment("note.txt", "abc"u8.ToArray(), "text/plain");

using var output = File.Create("hello.msg");
message.Save(output);

将 EML 转换为 MSG（以及反向转换）

MapiMessage.LoadFromEml() 接受文件路径、Stream，或包含标准 RFC 5322 / MIME 消息的 byte[]
内置的 MIME 解析器保留主题、纯文本
正文、HTML 正文、发件人、收件人以及所有附件——包括带有
Content-ID 标头的内联图像。SaveToEml() 将其序列化回 MIME，以实现完整的 EML ↔ MSG 循环转换
无需任何外部 MIME 库。

using System.IO;
using Aspose.Email.Foss.Msg;

using var input = File.OpenRead("message.eml");
var message = MapiMessage.LoadFromEml(input);

// Inspect fields parsed from MIME headers
Console.WriteLine(message.Subject);
Console.WriteLine(message.SenderEmailAddress);
Console.WriteLine(message.HtmlBody);

// Save as MSG for Outlook-compatible storage
using var msgOutput = File.Create("message.msg");
message.Save(msgOutput);

// Round-trip back to EML
using var emlOutput = File.Create("roundtrip.eml");
message.SaveToEml(emlOutput);

嵌入式消息附件

MSG 文件可以将另一个 MSG 文件作为附件——这是转发邮件链中的常见模式。AddEmbeddedMessageAttachment() 将 MapiMessage 对象作为嵌套的 .msg 附件添加。当读取时，MapiAttachment.IsEmbeddedMessage 指示嵌入的类型，EmbeddedMessage 直接公开嵌套的 MapiMessage。

using System.IO;
using Aspose.Email.Foss.Msg;

var parent = MapiMessage.Create("Outer", "Parent body");
var child = MapiMessage.Create("Inner", "Child body");
child.SenderEmailAddress = "inner@example.com";
parent.AddEmbeddedMessageAttachment(child, "inner.msg");

parent.Save("outer.msg");

var loaded = MapiMessage.FromFile("outer.msg");
var attachment = loaded.Attachments[0];

if (attachment.IsEmbeddedMessage)
    Console.WriteLine($"Embedded subject: {attachment.EmbeddedMessage!.Subject}");

CFB 容器读取和写入

Outlook MSG 文件基于复合文件二进制（CFB）格式构建——一种类似于 FAT 文件系统的分层二进制容器。CfbReader 展示完整的目录树：使用 IterChildren() 迭代存储和流，使用 ResolvePath() 通过路径链导航到特定条目，使用 GetStreamData() 读取原始流字节。CfbWriter.ToBytes() 将 CfbDocument 序列化为字节——这对于构建自定义 CFB 文档或验证无损往返非常有用。

using System.Text;
using Aspose.Email.Foss.Cfb;

// Build a CFB document from scratch
var document = new CfbDocument();
document.Root.AddStream(new CfbStream("ReadMe", Encoding.UTF8.GetBytes("hello")));
var storage = document.Root.AddStorage(new CfbStorage("DataStore"));
storage.AddStream(new CfbStream("Payload", Encoding.UTF8.GetBytes("content")));

byte[] bytes = CfbWriter.ToBytes(document);

// Read it back
using var reader = new CfbReader(bytes);
var entry = reader.ResolvePath(["DataStore", "Payload"]);
if (entry is not null)
{
    var data = reader.GetStreamData(entry.StreamId);
    Console.WriteLine(Encoding.UTF8.GetString(data)); // "content"
}

类型化 MAPI 属性访问

MapiPropertyCollection 为任何 MSG 或存储对象提供类型化的 MAPI 属性访问。
CommonMessagePropertyId 枚举覆盖所有标准 MAPI 属性标识符——Subject、Body、BodyHtml、SenderName、SenderEmailAddress、MessageDeliveryTime、InternetMessageId，以及包括 AttachFilename、AttachMimeTag 和 AttachContentId 在内的附件属性。使用 SetProperty() 和 GetPropertyValue() 可读取和写入超出 MapiMessage 上已命名便利字段的任意属性。

using Aspose.Email.Foss.Msg;

var message = MapiMessage.FromFile("sample.msg");

// Typed convenience properties
Console.WriteLine(message.Subject);
Console.WriteLine(message.SenderName);
Console.WriteLine(message.MessageDeliveryTime);

// Iterate all MAPI property keys
foreach (var key in message.IterPropertyKeys())
    Console.WriteLine($"0x{(ushort)key.PropertyId:X4} / {key.PropertyType}");

快速入门

dotnet add package Aspose.Email.Foss

using System.IO;
using Aspose.Email.Foss.Msg;

// Read an MSG file
using var stream = File.OpenRead("sample.msg");
var message = MapiMessage.FromStream(stream);
Console.WriteLine(message.Subject);
Console.WriteLine(message.SenderEmailAddress);
foreach (var recipient in message.Recipients)
    Console.WriteLine($"To: {recipient.EmailAddress}");
foreach (var attachment in message.Attachments)
    Console.WriteLine($"Attachment: {attachment.Filename} ({attachment.MimeType})");

支持的格式

格式扩展名读取写入
复合文件二进制.cfb✓✓
Outlook 消息.msg✓✓
MIME / EML.eml✓✓

开源与许可

Aspose.Email FOSS for .NET 在 MIT 许可证 下发布。可在个人，
商业和开源项目中自由使用，且没有使用限制。源代码可在 github.com/aspose-email-foss/Aspose.Email-FOSS-for-.Net 获取。

入门