Начало работы

Начало работы с Aspose.Email FOSS для .NET

Добро пожаловать в Aspose.Email FOSS for .NET, бесплатную библиотеку на C# с лицензией MIT для чтения, создания и записи файлов Outlook MSG, контейнеров Compound File Binary (CFB) и сообщений EML сообщений. Это руководство проведёт вас от создания нового проекта .NET до работы с файлами MSG за считанные минуты.


Требования

ТребованиеПодробности
.NET8.0 или новее
Менеджер пакетовNuGet (dotnet CLI или 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})");

Следующие шаги

  • Installation Guide: Настройка проекта и детали установки NuGet
  • Developer Guide: Операции с MSG, вложения, свойства MAPI и структура CFB
  • Features: Подробный разбор каждой функции с примерами на C#
 Русский