API Reference

Class

EmailMailboxReader

Namespace OfficeIMO.Email
Assembly OfficeIMO.Email
Modifiers sealed

Reads mboxo and mboxrd mailbox aggregates.

Inheritance

  • Object
  • EmailMailboxReader

Constructors

EmailMailboxReader 2 overloads
public EmailMailboxReader() #

Creates a reader with the default policy.

public EmailMailboxReader(EmailMailboxReaderOptions options) #

Creates a reader with an immutable policy.

Parameters

options OfficeIMO.Email.EmailMailboxReaderOptions requiredposition: 0

Methods

Read 3 overloads
public EmailMailboxReadResult Read(String filePath, CancellationToken cancellationToken = null) #
Returns: EmailMailboxReadResult

Reads a mailbox file.

Parameters

filePath System.String requiredposition: 0
cancellationToken System.Threading.CancellationToken = null optionalposition: 1
public EmailMailboxReadResult Read(Byte[] data, CancellationToken cancellationToken = null) #
Returns: EmailMailboxReadResult

Reads mailbox bytes.

Parameters

data System.Byte[] requiredposition: 0
cancellationToken System.Threading.CancellationToken = null optionalposition: 1
public EmailMailboxReadResult Read(Stream stream, CancellationToken cancellationToken = null) #
Returns: EmailMailboxReadResult

Reads without closing the stream. Seekable streams are read from the beginning and restored to their original position; non-seekable streams are read forward from their current position.

Parameters

stream System.IO.Stream requiredposition: 0
cancellationToken System.Threading.CancellationToken = null optionalposition: 1
ReadAsync 2 overloads
public async Task<EmailMailboxReadResult> ReadAsync(String filePath, CancellationToken cancellationToken = null) #
Returns: Task<EmailMailboxReadResult>

Asynchronously reads a mailbox file.

Parameters

filePath System.String requiredposition: 0
cancellationToken System.Threading.CancellationToken = null optionalposition: 1
public async Task<EmailMailboxReadResult> ReadAsync(Stream stream, CancellationToken cancellationToken = null) #
Returns: Task<EmailMailboxReadResult>

Asynchronously reads without closing the stream. Seekable streams are read from the beginning and restored to their original position; non-seekable streams are read forward.

Parameters

stream System.IO.Stream requiredposition: 0
cancellationToken System.Threading.CancellationToken = null optionalposition: 1
ReadEntries 2 overloads
public IEnumerable<EmailMailboxEntryReadResult> ReadEntries(String filePath, CancellationToken cancellationToken = null) #
Returns: IEnumerable<EmailMailboxEntryReadResult>

Enumerates a mailbox file while retaining at most one decoded message in memory.

Parameters

filePath System.String requiredposition: 0
cancellationToken System.Threading.CancellationToken = null optionalposition: 1
public IEnumerable<EmailMailboxEntryReadResult> ReadEntries(Stream stream, CancellationToken cancellationToken = null) #
Returns: IEnumerable<EmailMailboxEntryReadResult>

Enumerates a caller-owned mailbox stream while retaining at most one decoded message in memory. Seekable streams are restored to their original position when enumeration ends or is disposed.

Parameters

stream System.IO.Stream requiredposition: 0
cancellationToken System.Threading.CancellationToken = null optionalposition: 1

Properties

public EmailMailboxReaderOptions Options { get; } #

Reader policy used by this instance.