Aspose.Email FOSS
.NET
Guia do Desenvolvedor
Contêineres CFB

Contêineres CFB

Contêineres CFB

Compound File Binary (CFB) é o formato de contêiner usado pelos arquivos Outlook .msg. Aspose.Email FOSS for .NET fornece CfbReader para leitura e CfbWriter / CfbDocument para gravação de contêineres CFB diretamente.

Lendo Contêineres CFB

Abrir um arquivo CFB 

using Aspose.Email.Foss.Cfb;

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

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

// From byte array
var data = File.ReadAllBytes("sample.msg");
using var reader3 = new CfbReader(data);

Inspecionar Cabeçalho e Estrutura 

Console.WriteLine($"Version: {reader.MajorVersion}");
Console.WriteLine($"Sector size: {reader.SectorSize}");
Console.WriteLine($"Mini-sector size: {reader.MiniSectorSize}");
Console.WriteLine($"Directory entries: {reader.DirectoryEntryCount}");
Console.WriteLine($"Streams materialized: {reader.MaterializedStreamCount}");
Console.WriteLine($"File size: {reader.FileSize}");

Percorrer a Árvore de Diretórios 

// Full recursive traversal with depth
foreach (var (depth, entry) in reader.IterTree())
{
    var indent = new string(' ', depth * 2);
    Console.WriteLine($"{indent}{entry.Name} [{entry.ObjectType}]");
}

// Iterate only storages
foreach (var entry in reader.IterStorages())
    Console.WriteLine($"Storage: {entry.Name}");

// Iterate only streams
foreach (var entry in reader.IterStreams())
    Console.WriteLine($"Stream: {entry.Name} ({entry.StreamSize} bytes)");

Navegar pelos Filhos e Resolver Caminhos 

// Direct children of the root
foreach (var entry in reader.IterChildren(CfbConstants.RootStreamId))
    Console.WriteLine(entry.Name);

// Resolve a nested path
var target = reader.ResolvePath(new[] { "__substg1.0_0037001F" });
if (target != null)
{
    var streamData = reader.GetStreamData(target.Value);
    Console.WriteLine($"Stream data: {streamData.Length} bytes");
}

Encontrar um filho por nome 

var child = reader.FindChildByName(CfbConstants.RootStreamId, "__properties_version1.0");
if (child != null)
{
    var bytes = reader.GetStreamData(child.Value);
    Console.WriteLine($"Property stream: {bytes.Length} bytes");
}

Escrevendo Contêineres CFB

Construir um Documento CFB 

using Aspose.Email.Foss.Cfb;

var root = new CfbStorage("Root Entry");
root.AddStream(new CfbStream("data.bin", new byte[] { 0x01, 0x02, 0x03 }));

var subStorage = new CfbStorage("SubFolder");
subStorage.AddStream(new CfbStream("nested.txt", System.Text.Encoding.UTF8.GetBytes("hello")));
root.AddStorage(subStorage);

var document = new CfbDocument(root);

Serializar para Bytes ou Arquivo 

// To byte array
byte[] cfbBytes = CfbWriter.ToBytes(document);

// To file
CfbWriter.WriteFile(document, "output.cfb");

Verificação de Ida e Volta 

// Write and reload
CfbWriter.WriteFile(document, "test.cfb");
using var reloaded = CfbReader.FromFile("test.cfb");

foreach (var entry in reloaded.IterChildren(CfbConstants.RootStreamId))
    Console.WriteLine(entry.Name);

Carregar CFB existente como CfbDocument

CfbDocument fornece um modelo em memória para um arquivo CFB existente:

var doc = CfbDocument.FromFile("sample.msg");
Console.WriteLine($"Root: {doc.Root.Name}");
Console.WriteLine($"Version: {doc.MajorVersion}.{doc.MinorVersion}");

Veja também

 Português