Aspose.Email FOSS
.NET
Guia de Desenvolvedores
Leitura de ficheiros MSG

Leitura de ficheiros MSG

Leitura de ficheiros MSG

Este guia mostra como ler o Outlook . .msg Os arquivos que utilizam o Aspose.Email FOSS para .NET estão disponíveis em três níveis de acesso: o nível superior, o mais elevado e o máximo mínimo. MapiMessage API para acesso de campo tipado, nível médio MsgDocument/MsgReader para inspecção estrutural e de baixo nível, CfbReader para a travessia binária bruta.

Alto nível: MapiMessage

MapiMessage É a classe primária para leitura de arquivos MSG. expõe propriedades fortemente tipadas para todos os campos de correio eletrónico padrão.

Carregar a partir de Arquivo ou Fluxo

Chama-me . MapiMessage.FromFile() com um caminho de ficheiro, ou MapiMessage.FromStream() com um fluxo aberto, para carregar os dados de GMS na memória:

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);

O opcional strict Parâmetro permite a validação e preenche o ValidationIssues lista sem excepções:

// 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}");

Acessar campos de mensagens

Leia assunto, corpo, remetente, mensagem ID, tempo de entrega e classe da mensagens das propriedades fortemente digitado em MapiMessage:

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}");

Leia os destinatários

Iteração message.Recipients e verifique RecipientType para distinguir os destinatários de To, Cc e Bcc pelo seu nome de exibição e endereço de correio eletrónico:

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}>");
}

Leia anexos

Iteração message.Attachments para acessar o nome do arquivo, tipo MIME, bytes cru e qualquer embedded MapiMessage para os anexos de GMS aninhados:

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);
    }
}

Nível médio: MsgDocument e MssReader

Utilização: MsgDocument.FromFile() para abrir um arquivo MSG e navegar no armazenamento raiz, que contém sub-arquivos de destinatário e anexo acessíveis por seus servidores. Role propriedade.

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 dá acesso somente de leitura com validação:

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

Nível baixo: CfbReader

Para inspecção binária bruta, utilizar: CfbReader Para atravessar diretamente o recipiente 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");
    }
}

Ver também:

Ver também:

 Português