Aspose.Email FOSS
.NET
Guide du développeur
Lecture des fichiers MSG

Lecture des fichiers MSG

Lecture de fichiers MSG

Aspose.Email FOSS for .NET propose trois niveaux d’accès pour la lecture des fichiers Outlook .msg : l’API de haut niveau MapiMessage, le niveau intermédiaire MsgDocument/MsgReader, et le niveau bas CfbReader pour l’inspection binaire brute.

Niveau supérieur : MapiMessage

MapiMessage est la classe principale pour lire les fichiers MSG. Elle expose des propriétés fortement typées pour tous les champs d’e‑mail standard.

Charger à partir d’un fichier ou d’un flux 

using Aspose.Email.Foss.Msg;

// From file path
using var message = MapiMessage.FromFile("sample.msg");

// From stream
using var stream = File.OpenRead("sample.msg");
using var message2 = MapiMessage.FromStream(stream);

Le paramètre optionnel strict contrôle le comportement de validation :

// Strict mode — populates ValidationIssues but does not throw
using var message = MapiMessage.FromFile("sample.msg", strict: true);
foreach (var issue in message.ValidationIssues)
    Console.WriteLine($"Warning: {issue}");

Accéder aux champs du message 

Console.WriteLine($"Subject: {message.Subject}");
Console.WriteLine($"Body: {message.Body}");
Console.WriteLine($"HTML Body: {message.HtmlBody}");
Console.WriteLine($"From: {message.SenderName} <{message.SenderEmailAddress}>");
Console.WriteLine($"Message-ID: {message.InternetMessageId}");
Console.WriteLine($"Date: {message.MessageDeliveryTime}");
Console.WriteLine($"Message Class: {message.MessageClass}");

Lire les destinataires 

foreach (var recipient in message.Recipients)
{
    var type = recipient.RecipientType switch
    {
        MapiMessage.RecipientTypeTo  => "To",
        MapiMessage.RecipientTypeCc  => "Cc",
        MapiMessage.RecipientTypeBcc => "Bcc",
        _ => "Unknown"
    };
    Console.WriteLine($"  {type}: {recipient.DisplayName} <{recipient.EmailAddress}>");
}

Lire les pièces jointes 

foreach (var attachment in message.Attachments)
{
    Console.WriteLine($"  {attachment.Filename} ({attachment.MimeType})");

    if (attachment.IsEmbeddedMessage)
    {
        Console.WriteLine($"    Embedded subject: {attachment.EmbeddedMessage!.Subject}");
    }
    else
    {
        File.WriteAllBytes(attachment.Filename!, attachment.Data);
    }
}

Niveau intermédiaire : MsgDocument et MsgReader

MsgDocument fournit un accès à l’arborescence de stockage MSG — stockages, flux, destinataires et pièces jointes en tant qu’éléments structurels.

using Aspose.Email.Foss.Msg;

var document = MsgDocument.FromFile("sample.msg");

// Navigate storages by role
foreach (var storage in document.Root.Storages)
{
    Console.WriteLine($"{storage.Name} — role: {storage.Role}");

    if (storage.Role == MsgStorageRole.Recipient)
        Console.WriteLine("  (recipient storage)");
    else if (storage.Role == MsgStorageRole.Attachment)
        Console.WriteLine("  (attachment storage)");
}

MsgReader donne un accès en lecture seule avec validation :

using var reader = MsgReader.FromFile("sample.msg", strict: true);
Console.WriteLine($"Validation issues: {reader.ValidationIssues.Count}");

Bas niveau : CfbReader

Pour l’inspection binaire brute, utilisez CfbReader pour parcourir directement le conteneur CFB :

using Aspose.Email.Foss.Cfb;

using var reader = CfbReader.FromFile("sample.msg");

// Traverse the full directory tree
foreach (var (depth, entry) in reader.IterTree())
{
    var indent = new string(' ', depth * 2);
    Console.WriteLine($"{indent}{entry.Name} [type={entry.ObjectType}, size={entry.StreamSize}]");
}

// Read raw stream data
var rootChildren = reader.IterChildren(CfbConstants.RootStreamId);
foreach (var entry in rootChildren)
{
    if (entry.IsStream())
    {
        var data = reader.GetStreamData(entry.StreamId);
        Console.WriteLine($"{entry.Name}: {data.Length} bytes");
    }
}

Voir aussi

 Français