入门指南

Aspose.Email FOSS for .NET 入门指南

欢迎使用 Aspose.Email FOSS for .NET，这是一款免费、MIT 许可证的 C# 库，用于读取，
创建和写入 Outlook MSG 文件、复合文件二进制（CFB）容器以及 EML
消息。本指南将帮助您从全新的 .NET 项目快速开始，在几分钟内使用 MSG 文件。

先决条件

要求细节
.NET8.0 或更高
包管理器NuGet (dotnet CLI or Visual Studio)
操作系统Windows、macOS 或 Linux
依赖项无 — 纯托管 C#

安装

从 NuGet 安装：

dotnet add package Aspose.Email.Foss

在最小的控制台应用程序中验证：

using Aspose.Email.Foss.Msg;

var message = MapiMessage.Create("Test", "Hello");
Console.WriteLine($"Subject: {message.Subject}");
// Output: Subject: Test

请参阅Installation Guide了解项目设置详情。

您可以做什么

安装后，您可以立即：

  • 读取 MSG 文件，使用 MapiMessage.FromStream() 或 MapiMessage.FromFile() — 访问主题、正文、HTML 正文、发件人、收件人和附件
  • 创建 MSG 消息从头开始，使用 MapiMessage.Create() — 设置所有字段，添加收件人和附件，然后使用 message.Save() 序列化
  • 转换 MSG 与 EML（MIME/RFC 5322）之间，使用 LoadFromEml() 和 SaveToEml()
  • 检查 底层 CFB 二进制容器，使用 CfbReader — 遍历存储和流，解析路径，读取原始字节
  • 写入 CFB 文档，使用 CfbWriter 用于取证检查或格式构建
  • 处理附件 — 添加文件、流或嵌入的 MSG 附件，并包含完整的元数据

快速入门

读取 MSG 文件并打印其主题和收件人：

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

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

Console.WriteLine($"Subject: {message.Subject}");
Console.WriteLine($"From: {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})");

后续步骤

 中文