将 EML 消息导入 PST 文件是一项常见要求,尤其是对于在电子邮件客户端之间迁移或存档电子邮件以进行存储和备份的用户。 PST 格式保留了内容的结构、格式和附件,使其适合在 Outlook 应用程序中无缝集成和管理。
这种专有的 Microsoft 文件格式的主要优势是能够创建电子邮件数据的本地存档,从而可以离线管理和访问电子邮件、联系人和其他相关信息。 在本文中,我们将探讨如何使用渐进式 C# 库以及代码示例和步骤轻松高效地将 EML 导入 PST。
Aspose.Email 是用于轻松的开发 email 功能的应用程序的一组控件,基于 ASP.NET 的Web应用、Web服务和Windows 应用。支持 Outlook PST, EML, MSG, and MHT 格式. 允许开发者直接与 SMTP, POP, FTP, 和 MS Exchange 服务器进行工作。支持邮件合并、行事历、定制邮件标题和内容、嵌入文件等,Aspose API支持流行文件格式处理,并允许将各类文档导出或转换为固定布局文件格式和最常用的图像/多媒体格式。
.NET API 管理 EML
Aspose.Email for .NET是一个强大且多功能的 API,它提供了广泛的功能,可用于在 .NET 应用程序中处理电子邮件和邮件服务器。该 API 可与流行的电子邮件协议和格式无缝集成,使开发人员能够轻松创建和操作电子邮件。
Aspose.Email 的一个显著特点是它广泛支持在不同格式之间转换电子邮件,包括将 EML 转换为 PST。通过利用 Aspose.Email 提供的丰富类和方法,开发人员可以执行复杂的电子邮件相关任务,例如处理附件、管理文件夹以及在各种格式之间转换电子邮件。在深入研究代码之前,您需要将该库集成到您的 C# 项目中。您可以通过从 Aspose 网站下载或使用NuGet轻松获取它。
Install-Package Aspose.Email
一旦该库成为您的项目的一部分,您就可以开始编码了。
将单个 EML 消息导入 PST 文件
Aspose.Email 综合 API 提供了简单直观的代码示例和将 EML 消息添加到 PST 文件的步骤:
- 使用PersonalStorage类的Create方法创建一个新的个人存储文件,并指定文件名和格式版本作为参数。
- 使用PersonalStorage类的CreatePredefinedFolder方法在 PST 文件中创建预定义的“收件箱”文件夹,指定“收件箱”作为文件夹名称,指定 StandardIpmFolder.Inbox 作为文件夹类型。
- 使用MapiMessage类的“Load”方法从文件加载电子邮件消息,并指定其名称和 EmlLoadOptions 实例作为参数。
- 使用FolderInfo类的AddMessage方法将加载的电子邮件消息添加到 PST 文件中先前创建的收件箱文件夹。
using (var pst = PersonalStorage.Create("test.pst", FileFormatVersion.Unicode)) { var inboxFolder = pst.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox); var msg = MapiMessage.Load("test.eml", new EmlLoadOptions()); inboxFolder.AddMessage(msg); }
结果,创建了一个名为“test.pst”的新个人存储文件,从文件“test.eml”加载的消息被添加到收件箱文件夹,并可供进一步操作或存储。
将多个 EML 消息导入 PST 文件
Aspose.Email 可以将文件夹中的一组消息添加到 PST 文件中。FolderInfo类的AddMessages方法允许您将多条 EML 消息导入存储文件中的收件箱文件夹。以下代码示例将向您展示如何在项目中实现此功能:
- 使用PersonalStorage类的Create方法创建一个新的个人存储文件,并指定文件名和格式版本作为参数。
- 使用PersonalStorage类的CreatePredefinedFolder方法在 PST 文件中创建预定义的“收件箱”文件夹,指定“收件箱”作为文件夹名称,指定 StandardIpmFolder.Inbox 作为文件夹类型。
- 使用FolderInfo类的AddMessages方法将文件夹中的一封或多封电子邮件添加到 PST 文件中先前创建的收件箱文件夹中,并指定一个代表要从指定文件夹路径导入的消息的 MapiMessageEnumerator 对象。
using (var pst = PersonalStorage.Create("test.pst", FileFormatVersion.Unicode)) { var inboxFolder = pst.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox); inboxFolder.AddMessages(new MapiMessageEnumerator("PathToFolder")); }
在这里,我们利用“MapiMessageEnumerator”遍历源文件夹中的 EML 文件并将它们添加到 PST 文件中。
MapiMessage 枚举器实现
使用 Aspose.Email,您可以定义实现 IEnumerable 接口的“MapiMessageEnumerator”类。此类允许迭代 MapiMessage 对象集合,表示电子邮件消息,以 .eml 文件形式存储在指定文件夹中。MapiMessageEnumerator 中的 Enumerator 嵌套类用作迭代器,将 EML 文件加载为 MapiMessage 对象并管理迭代过程。它具有迭代文件、处理资源和重置枚举器的方法。
以下代码示例将向您展示如何以编程方式遍历 MapiMessages 集合:
- 定义“MapiMessageEnumerator”类接受“folderPath”参数,该参数指示.eml 文件所在的目录。
- 使用“GetEnumerator”方法创建并返回“Enumerator”类的新实例,传递文件夹路径。
- 将“folderPath”存储在一个字段中,并使用“IEnumerator”遍历文件夹内的文件路径。
- 当构造“Enumerator”类时,初始化“folderPath”并调用“Reset()”方法来准备“fileEnumerator”。
- 明确实现“Current”属性和 IEnumerator 的 Current 属性。
- 如果存在“fileEnumerator”和当前“MapiMessage”,则提供“Dispose”方法来处理它们。
- 使用“MoveNext”方法遍历文件路径,尝试从文件加载“MapiMessage”,并记录或处理发生的任何错误。
- 在“Reset”方法中,处理“fileEnumerator”并通过枚举“folderPath”中的.eml 文件创建一个新的。
public class MapiMessageEnumerator : IEnumerable<MapiMessage> { private readonly string folderPath; public MapiMessageEnumerator(string folderPath) { this.folderPath = folderPath; } public IEnumerator<MapiMessage> GetEnumerator() { return new Enumerator(folderPath); } IEnumerator IEnumerable.GetEnumerator() { return GetEnumerator(); } private class Enumerator : IEnumerator<MapiMessage> { private readonly string folderPath; private IEnumerator<string> fileEnumerator; public Enumerator(string folderPath) { this.folderPath = folderPath; Reset(); } public MapiMessage Current { get; private set; } object IEnumerator.Current { get { return Current; } } public void Dispose() { fileEnumerator.Dispose(); Current?.Dispose(); } public bool MoveNext() { while (fileEnumerator.MoveNext()) { var filePath = fileEnumerator.Current; try { Current?.Dispose(); // Dispose previous MailMessage if any Current = MapiMessage.Load(filePath, new EmlLoadOptions()); return true; } catch (Exception ex) { // Log or handle the error Console.WriteLine($"Failed to parse message: {ex.Message}"); } } return false; } public void Reset() { fileEnumerator?.Dispose(); fileEnumerator = Directory.EnumerateFiles(folderPath, "*.eml").GetEnumerator(); Current = null; } } }
结论
总之,无论您是在电子邮件客户端之间迁移还是存档电子邮件数据以进行存储和备份,Aspose.Email for .NET 都提供了可靠且功能丰富的解决方案,用于将 EML 文件转换为 PST 格式,使其成为一个高效而直接的过程。借助直观的代码示例和全面的文档,开发人员可以毫不费力地将这一基本功能实现到他们的项目中。