Aspose.Email FOSS
.NET
Руководство разработчика
Контейнеры CFB

Контейнеры CFB

Контейнеры CFB

Compound File Binary (CFB) — это формат контейнера, используемый файлами Outlook .msg. Aspose.Email FOSS for .NET предоставляет CfbReader для чтения и CfbWriter / CfbDocument для записи контейнеров CFB напрямую.

Чтение контейнеров CFB

Открыть файл 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);

Проверка заголовка и структуры 

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

Обход дерева каталогов 

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

Навигация по дочерним элементам и разрешение путей 

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

Найти дочерний элемент по имени 

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

Запись CFB контейнеров

Создать документ 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);

Сериализовать в байты или файл 

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

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

Проверка обратного пути 

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

Загрузить существующий CFB как CfbDocument

CfbDocument предоставляет модель в памяти для существующего файла CFB:

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

См. также

  • Reading MSG Files — Высокоуровневый доступ к MSG через MapiMessage
  • MAPI Properties — Доступ к потокам свойств MAPI
  • Features — Полный справочник функций
 Русский