Електронна пошта формат конвертер
Як перетворити EML і MSG електронні файли в HTML в .NET

Як перетворити EML і MSG електронні файли в HTML в .NET

Конвертація файлів електронної пошти в HTML-формат є необхідною для веб-заснованих додатків, систем архівування електронних листів та сучасних рішень з управління документами. HTML забезпечує різноманітний формат, який дозволяє легко переглядати, стилізувати та інтегрувати контент електронного пошту в системи, засновані на Інтернеті. The Aspose.Email LowCode Converter упрощає цей процес, дозволяючи розробникам трансформувати EML і МЗС Файли в HTML з мінімальною складністю коду.

Передумови

Перед тим, як реалізувати конверсію електронної пошти в HTML, переконайтеся, що ваше середовище розвитку включає:

  • Visual Studio 2019 або пізніше (або будь-який сумісний .NET IDE)
  • .NET 6.0 SDK або вище
  • Aspose.Email NuGet пакет
  • Основні знання C# та обробки файлів

Крок 1: Встановіть Aspose.Email через NuGet

Завантажити пакет Aspose.Email за допомогою одного з таких методів:

Консоль менеджерів упаковки:

Install-Package Aspose.Email

Управління упаковкою UI:

  • Натисніть правою кнопкою на ваш проект в Solution Explorer
  • Виберіть «Управління пакетами NuGet"
  • Пошук за посиланням «Aspose.email"
  • Натисніть «Install"

Посилання на упаковку в .csproj:

<PackageReference Include="Aspose.Email" Version="24.3.0" />

Крок 2: Напишіть код конверсії

Ось повний приклад, який демонструє конвертацію одного файлу з EML/MSG в HTML:

using Aspose.Email.LowCode;
using System;
using System.IO;
using System.Threading.Tasks;

namespace EmailToHtmlConverter
{
    class Program
    {
        static async Task Main(string[] args)
        {
            try
            {
                // Define input and output paths
                string inputFilePath = @"C:\Emails\sample.eml";
                string outputDirectory = @"C:\ConvertedEmails";
                
                // Create output directory if it doesn't exist
                Directory.CreateDirectory(outputDirectory);
                
                // Create input stream from the email file
                using var inputStream = File.OpenRead(inputFilePath);
                
                // Set up the output handler to save converted files
                var outputHandler = new FolderOutputHandler(outputDirectory);
                
                // Get the filename for processing
                string fileName = Path.GetFileName(inputFilePath);
                
                // Convert the email file to HTML
                await Converter.ConvertToHtml(inputStream, fileName, outputHandler);
                
                Console.WriteLine($"Successfully converted {fileName} to HTML format");
                Console.WriteLine($"Output saved to: {outputDirectory}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Conversion failed: {ex.Message}");
            }
        }
    }
}

Код розриву:

  • Створення вхідного потоку: File.OpenRead() створює потік з джерело електронної пошти файлу
  • Налаштування оператора виходу: FolderOutputHandler Управління, де конвертовані HTML-файли зберігаються
  • Конвертаційне виконання: Converter.ConvertToHtml() здійснює реальну трансформацію
  • Управління ресурсами: using Декларації забезпечують правильне розташування файлових потоків

Крок 3: Обробка кількох файлів (Batch Conversion)

Для обробки декількох електронних файлів одночасно, реалізуйте конвертацію пакетів:

using Aspose.Email.LowCode;
using System;
using System.IO;
using System.Linq;
using System.Threading.Tasks;

public class BatchEmailConverter
{
    public static async Task ConvertMultipleEmailsToHtml()
    {
        try
        {
            // Define directories
            string inputDirectory = @"C:\EmailFiles";
            string outputDirectory = @"C:\ConvertedEmails";
            
            // Create output directory
            Directory.CreateDirectory(outputDirectory);
            
            // Get all EML and MSG files from input directory
            var emailFiles = Directory.GetFiles(inputDirectory, "*.*")
                .Where(file => file.EndsWith(".eml", StringComparison.OrdinalIgnoreCase) || 
                              file.EndsWith(".msg", StringComparison.OrdinalIgnoreCase))
                .ToArray();
            
            Console.WriteLine($"Found {emailFiles.Length} email files to convert");
            
            // Set up output handler
            var outputHandler = new FolderOutputHandler(outputDirectory);
            
            // Process each file
            var conversionTasks = emailFiles.Select(async filePath =>
            {
                try
                {
                    using var inputStream = File.OpenRead(filePath);
                    string fileName = Path.GetFileName(filePath);
                    
                    await Converter.ConvertToHtml(inputStream, fileName, outputHandler);
                    
                    Console.WriteLine($"✓ Converted: {fileName}");
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"✗ Failed to convert {Path.GetFileName(filePath)}: {ex.Message}");
                }
            });
            
            // Execute all conversions concurrently
            await Task.WhenAll(conversionTasks);
            
            Console.WriteLine("Batch conversion completed!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Batch conversion failed: {ex.Message}");
        }
    }
}

Прогресивні теми

Ім’я пристосованого виходу

Створіть персоналізований оператор виходу для контролю назви файлів:

public class TimestampOutputHandler : IOutputHandler
{
    private readonly string _basePath;
    
    public TimestampOutputHandler(string basePath)
    {
        _basePath = basePath;
        Directory.CreateDirectory(_basePath);
    }
    
    public async Task AddOutputStream(string name, Func<Stream, Task> writeAction)
    {
        // Add timestamp prefix to the filename
        var timestamp = DateTime.Now.ToString("yyyyMMdd_HHmmss");
        var nameWithoutExtension = Path.GetFileNameWithoutExtension(name);
        var extension = ".html"; // Force HTML extension
        var newFileName = $"{timestamp}_{nameWithoutExtension}{extension}";
        var outputPath = Path.Combine(_basePath, newFileName);
        
        using var fileStream = File.Create(outputPath);
        await writeAction(fileStream);
        
        Console.WriteLine($"Created: {newFileName}");
    }
    
    public void AddOutputStream(string name, Action<Stream> writeAction)
    {
        // Synchronous version
        var timestamp = DateTime.Now.ToString("yyyyMMdd_HHmmss");
        var nameWithoutExtension = Path.GetFileNameWithoutExtension(name);
        var extension = ".html";
        var newFileName = $"{timestamp}_{nameWithoutExtension}{extension}";
        var outputPath = Path.Combine(_basePath, newFileName);
        
        using var fileStream = File.Create(outputPath);
        writeAction(fileStream);
    }
}

// Usage example:
var customHandler = new TimestampOutputHandler(@"C:\ConvertedEmails");
await Converter.ConvertToHtml(inputStream, fileName, customHandler);

Загальне обробка помилок

Використання міцного обробки помилок для виробничих середовищ:

public class RobustEmailConverter
{
    public static async Task<ConversionResult> ConvertEmailToHtml(string inputPath, string outputDirectory)
    {
        var result = new ConversionResult();
        
        try
        {
            // Validate input file exists
            if (!File.Exists(inputPath))
            {
                throw new FileNotFoundException($"Input file not found: {inputPath}");
            }
            
            // Validate file extension
            var extension = Path.GetExtension(inputPath).ToLower();
            if (extension != ".eml" && extension != ".msg")
            {
                throw new ArgumentException($"Unsupported file format: {extension}");
            }
            
            // Create output directory
            Directory.CreateDirectory(outputDirectory);
            
            // Perform conversion
            using var inputStream = File.OpenRead(inputPath);
            var outputHandler = new FolderOutputHandler(outputDirectory);
            string fileName = Path.GetFileName(inputPath);
            
            await Converter.ConvertToHtml(inputStream, fileName, outputHandler);
            
            result.Success = true;
            result.OutputPath = Path.Combine(outputDirectory, Path.ChangeExtension(fileName, ".html"));
            result.Message = "Conversion completed successfully";
        }
        catch (FileNotFoundException ex)
        {
            result.Success = false;
            result.ErrorType = "FileNotFound";
            result.Message = ex.Message;
        }
        catch (UnauthorizedAccessException ex)
        {
            result.Success = false;
            result.ErrorType = "AccessDenied";
            result.Message = $"Access denied: {ex.Message}";
        }
        catch (ArgumentException ex)
        {
            result.Success = false;
            result.ErrorType = "InvalidArgument";
            result.Message = ex.Message;
        }
        catch (Exception ex)
        {
            result.Success = false;
            result.ErrorType = "UnknownError";
            result.Message = $"Unexpected error: {ex.Message}";
        }
        
        return result;
    }
}

public class ConversionResult
{
    public bool Success { get; set; }
    public string Message { get; set; }
    public string ErrorType { get; set; }
    public string OutputPath { get; set; }
}

Заключення

The Aspose.Email LowCode Converter надає ускладнене рішення для конвертації EML і MSG файлів в HTML формат:

  • Простий API : мінімальний код, необхідний для складних конверсій
  • Batch Processing : Ефективно обробляти кілька файлів з одночасними операціями
  • Флексибильний вихід : персоналізовані оператори для спеціалізованих вимог до назви та зберігання
  • Robust Error Handling : всеосяжне управління винятками для виробництва
  • Асинхронна підтримка : операції без блокування для кращої продуктивності додатків

Цей підхід дозволяє розробникам безперервно інтегрувати конверсію електронної пошти в HTML в веб-приклади, системи управління документами та рішення електронного архівування. Вихід HTML підтримує оригінальний форматинг електронних листів, забезпечуючи сумісність з сучасними стандартами веб і відповідними дизайнерськими рамками.

 Українська