Введение

Эффективное управление документами электронной почты часто подразумевает отслеживание процесса их преобразования. Aspose.Email for .NET предоставляет надежные инструменты для этого, позволяя разработчикам эффективно обрабатывать операции с электронной почтой. В этом руководстве подробно рассматривается отслеживание процесса преобразования документов электронной почты в C# с пошаговым описанием процесса для простоты понимания.

Предпосылки

Прежде чем приступить к выполнению инструкции, давайте убедимся, что у вас все настроено:

Aspose.Email для .NET: загрузите и установите Aspose.Email для .NET библиотека.
Среда разработки: установите Visual Studio или любую другую совместимую с .NET IDE.
.NET Framework: Убедитесь, что установлен .NET Framework 4.5 или более поздняя версия.
Временная лицензия: рассмотрите возможность получения временная лицензия для изучения всех возможностей Aspose.Email.
Пример файла электронной почты: подготовьте .eml файл (например, test.eml) для использования в качестве образца.

Импортные пакеты

Чтобы использовать Aspose.Email в вашем проекте, вам необходимо импортировать необходимые пространства имён. Добавьте следующие операторы using в начало файла:

using Aspose.Email;
using Aspose.Email.Mime;
using Aspose.Email.SaveOptions;
using System;
using System.IO;

Шаг 1: Настройте свой проект

Начнем с создания нового консольного приложения C# в Visual Studio. Оно послужит основой для реализации отслеживания конверсий электронных документов.

Откройте Visual Studio и создайте новый проект консольного приложения.
Установите пакет NuGet Aspose.Email:

Install-Package Aspose.Email

Добавьте .eml файл в каталог вашего проекта.

Шаг 2: загрузка файла электронной почты

Теперь загрузите файл электронной почты в MailMessage Объект. Это первый шаг в работе с данными электронной почты.

string dataDir = "Your Document Directory";
var fileName = dataDir + "test.eml";
MailMessage msg = MailMessage.Load(fileName);

dataDir: Указывает каталог, в котором находится файл вашей электронной почты.
MailMessage.Load: Читает .eml файл и подготавливает его к дальнейшим операциям.

Шаг 3: Инициализация потока памяти

Далее создайте MemoryStream объект для временного хранения преобразованных данных электронной почты.

MemoryStream ms = new MemoryStream();

А MemoryStream здесь используется для управления выходными данными процесса преобразования без сохранения данных непосредственно на диск.

Шаг 4: Определите параметры конвертации

Настройте EmlSaveOptions с настраиваемым обработчиком прогресса для отслеживания хода преобразования.

EmlSaveOptions opt = new EmlSaveOptions(MailMessageSaveType.EmlFormat);
opt.CustomProgressHandler = new ConversionProgressEventHandler(ShowEmlConversionProgress);

MailMessageSaveType.EmlFormat: Задает формат вывода.
CustomProgressHandler: Назначает пользовательскую функцию обработчика для отслеживания прогресса.

Шаг 5: Сохраните электронное письмо в потоке памяти

Сохранить MailMessage объект с использованием указанных параметров, включающий функцию отслеживания прогресса.

msg.Save(ms, opt);

Этот шаг инициирует процесс преобразования электронной почты и отправляет обновления обработчику хода выполнения.

Шаг 6: Реализация обработчика прогресса

Определите ShowEmlConversionProgress метод обработки обновлений прогресса и отображения их в консоли.

private static void ShowEmlConversionProgress(ProgressEventHandlerInfo info)
{
    int total;
    int saved;

    switch (info.EventType)
    {
        case ProgressEventType.MimeStructureCreated:
            total = info.TotalMimePartCount;
            saved = info.SavedMimePartCount;
            Console.WriteLine($"MimeStructureCreated - TotalMimePartCount: {total}");
            Console.WriteLine($"MimeStructureCreated - SavedMimePartCount: {saved}");
            break;

        case ProgressEventType.MimePartSaved:
            total = info.TotalMimePartCount;
            saved = info.SavedMimePartCount;
            Console.WriteLine($"MimePartSaved - TotalMimePartCount: {total}");
            Console.WriteLine($"MimePartSaved - SavedMimePartCount: {saved}");
            break;

        case ProgressEventType.SavedToStream:
            total = info.TotalMimePartCount;
            saved = info.SavedMimePartCount;
            Console.WriteLine($"SavedToStream - TotalMimePartCount: {total}");
            Console.WriteLine($"SavedToStream - SavedMimePartCount: {saved}");
            break;
    }
}

ProgressEventHandlerInfo: Предоставляет подробную информацию о процессе конвертации.
Случаи переключения: обработка различных этапов преобразования: MimeStructureCreated, MimePartSaved, и SavedToStream.

Чего ожидать?

По мере выполнения преобразования на консоли будут выводиться подробные обновления, например:

MimeStructureCreated - TotalMimePartCount: 10  
MimeStructureCreated - SavedMimePartCount: 3  
MimePartSaved - TotalMimePartCount: 10  
MimePartSaved - SavedMimePartCount: 5

Заключение

Отслеживать ход преобразования документов электронной почты на C# стало ещё проще благодаря Aspose.Email для .NET. Следуя этому руководству, вы научились загружать файлы электронных писем, настраивать обработчик хода выполнения и сохранять данные писем, контролируя весь процесс. Эта функция позволяет вам быть в курсе событий и контролировать все операции с документами электронной почты.

Часто задаваемые вопросы

Могу ли я использовать этот код для форматов, отличных от `.eml`?

Да, изменить MailMessageSaveType для соответствия другим форматам, таким как MSG или MHTML.

Как обрабатывать большие файлы электронной почты?

Рассмотрите возможность использования FileStream вместо MemoryStream для лучшей производительности при работе с большими файлами.

Что такое временная лицензия и как ее получить?

Временная лицензия позволяет вам бесплатно оценить все функции библиотеки. Получить её здесь.

Могу ли я интегрировать этот код в веб-приложение?

Да, код совместим с веб-приложениями, использующими ASP.NET или аналогичные фреймворки.

Где я могу найти дополнительные ресурсы?

Проверьте документация или посетите форум поддержки за помощью.