Represents an MBOX file and provides methods for reading and extracting messages. The MBOX file format is used for storing a collection of email messages. More...

Inherits IDisposable.

Inherited by Aspose::Email::Storage::Mbox::MboxoStorageReader, and Aspose::Email::Storage::Mbox::MboxrdStorageReader.

Public Member Functions
System::SharedPtr< System::IO::Stream >	get_BaseStream () const
	Gets the base stream. More...

int64_t	get_CurrentDataSize () const
	Gets the number of bytes that is read by ReadNextMessage method. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MailMessage > > >	EnumerateMessages ()
	Exposes the enumerator, which supports an iteration of messages in storage. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MailMessage > > >	EnumerateMessages (System::SharedPtr< Tools::Search::MailQuery > query)
	Enumerates the mail messages that match the specified query. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MailMessage > > >	EnumerateMessages (int32_t startIndex, int32_t count)
	Enumerates a specified number of mail messages, starting from the given index. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MboxMessageInfo > > >	EnumerateMessageInfo ()
	Exposes the enumerator, which supports an iteration of messages in storage. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MboxMessageInfo > > >	EnumerateMessageInfo (System::SharedPtr< Tools::Search::MailQuery > query)
	Enumerates the message information that matches the specified query. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MboxMessageInfo > > >	EnumerateMessageInfo (int32_t startIndex, int32_t count)
	Enumerates a specified number of message information entries, starting from the given index. More...

System::SharedPtr< MailMessage >	ExtractMessage (System::String id, System::SharedPtr< EmlLoadOptions > options)
	Get the message from MBOX. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MailMessage > > >	EnumerateMessages (System::SharedPtr< EmlLoadOptions > options)
	Exposes the enumerator, which supports an iteration of messages in storage. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MailMessage > > >	EnumerateMessages (System::SharedPtr< EmlLoadOptions > options, System::SharedPtr< Tools::Search::MailQuery > query)
	Enumerates the mail messages that match the specified query, using the provided load options. More...

System::SharedPtr< System::Collections::Generic::IEnumerable< System::SharedPtr< MailMessage > > >	EnumerateMessages (System::SharedPtr< EmlLoadOptions > options, int32_t startIndex, int32_t count)
	Enumerates a specified number of mail messages, starting from the given index, using the provided load options. More...

void	SplitInto (int64_t chunkSize, System::String outputPath)
	Splits the mbox storage into less sized parts. More...

void	SplitInto (int64_t chunkSize, System::String outputPath, System::String partFileNamePrefix)
	Splits the mbox storage into less sized parts. More...

void	Cancel ()
	This method used to interrupt a split operation. More...

virtual System::SharedPtr< MailMessage >	ReadNextMessage ()=0
	Reads the next message from underlying storage stream. More...

virtual System::SharedPtr< MailMessage >	ReadNextMessage (System::String &fromMarker)=0
	Reads the next message from underlying storage stream. More...

virtual System::SharedPtr< MailMessage >	ReadNextMessage (System::SharedPtr< EmlLoadOptions > options)=0
	Reads the next message from underlying storage stream. More...

virtual System::SharedPtr< MailMessage >	ReadNextMessage (System::String &fromMarker, System::SharedPtr< EmlLoadOptions > options)=0
	Reads the next message from underlying storage stream. More...

virtual System::SharedPtr< MboxMessageInfo >	NextMessage ()=0
	Gets the next message info. More...

virtual int32_t	GetTotalItemsCount ()=0
	Returns the number of messages in a storage. More...

virtual void	SetPositionByIndex (int32_t index)=0

virtual System::SharedPtr< MailMessage >	ReadNextMessage (System::SharedPtr< EmlLoadOptions > options, int32_t count)=0

virtual System::SharedPtr< MboxMessageInfo >	NextMessage (int32_t count)=0

void	Dispose () override
	Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. More...

VentureLicenseState	GetVentureLicenseState ()

Static Public Member Functions
static System::SharedPtr< MboxStorageReader >	CreateReader (System::SharedPtr< System::IO::Stream > stream, System::SharedPtr< MboxLoadOptions > options)
	Creates the instance of reader. More...

static System::SharedPtr< MboxStorageReader >	CreateReader (System::String fileName, System::SharedPtr< MboxLoadOptions > options)
	Creates the instance of reader. More...

static bool	ByteArrayStartsFromMarker (System::ArrayPtr< uint8_t > array, System::ArrayPtr< uint8_t > marker)
	Checks whether the array starts from given marker. More...

static bool	ContainsAsctime (System::ArrayPtr< uint8_t > currentLine)
	Determines whether the specified line contains asctime string. More...

static System::ArrayPtr< uint8_t >	ReadLine (System::SharedPtr< System::IO::Stream > stream)
	Reads the line from stream. More...

Public Attributes
int32_t	msgCount

System::SharedPtr< System::Object >	mVentureLicense

System::Event< void(System::SharedPtr< System::Object >, System::SharedPtr< Aspose::Email::Storage::MimeItemCopyEventArgs >)>	EmlCopying
	Event that occurs before the MailMessage object copy process, within the SplitInto(long, string) method. More...

System::Event< void(System::SharedPtr< System::Object >, System::SharedPtr< Aspose::Email::Storage::MimeItemCopyEventArgs >)>	EmlCopied
	Event that occurs after successful copy of a MailMessage object within the SplitInto(long, string) method. More...

System::Event< void(System::SharedPtr< System::Object >, System::SharedPtr< Aspose::Email::Storage::NewStorageEventArgs >)>	MboxFileCreated
	Event that occurs when a new MBOX file is created during the SplitInto(long, string) method. More...

System::Event< void(System::SharedPtr< System::Object >, System::SharedPtr< Aspose::Email::Storage::NewStorageEventArgs >)>	MboxFileFilled
	Event that occurs after filling an MBOX file with data within the SplitInto(long, string) method. More...

Static Public Attributes
static System::ArrayPtr< uint8_t >	FromMarker
	"From " signature, indicates a start of the message. More...

static System::ArrayPtr< uint8_t >	EmptyFromMarkerCRLF

static System::ArrayPtr< uint8_t >	EmptyFromMarkerCR

static System::ArrayPtr< uint8_t >	EmptyFromMarkerLF

static System::ArrayPtr< uint8_t >	MboxoMarker
	The mbox format uses a single blank line followed by the string 'From ' (with a space) to delimit messages. In mboxo format sender's email address in message delimiter is replaced by the constant string '???@???', i.e. 'From ???@???' More...

Protected Member Functions
void	set_CurrentDataSize (int64_t value)
	Gets the number of bytes that is read by ReadNextMessage method. More...

	MboxStorageReader (System::SharedPtr< System::IO::Stream > stream, System::SharedPtr< MboxLoadOptions > options)
	Initializes a new instance of the MboxStorageReader class. More...

	MboxStorageReader (System::String fileName, System::SharedPtr< MboxLoadOptions > options)
	Initializes a new instance of the MboxStorageReader class. More...

virtual void	Dispose (bool disposing)
	Releases unmanaged and - optionally - managed resources More...

virtual	~MboxStorageReader ()

Protected Attributes
System::SharedPtr< System::Text::Encoding >	preferredTextEncoding

Friends
class	MboxoStorageReader

class	MboxrdStorageReader

Detailed Description

Represents an MBOX file and provides methods for reading and extracting messages. The MBOX file format is used for storing a collection of email messages.

The following code provided is intended for processing email messages stored in an MBOX file using the MboxStorageReader class.

[C#]

// Create an instance of the MboxStorageReader using the factory method 'CreateReader'.
var mbox = MboxStorageReader.CreateReader("storage.mbox", new MboxLoadOptions());
 
// Iterate through each message info object in the mbox storage.
foreach (var mboxMessageInfo in mbox.EnumerateMessageInfo())
{
    Console.WriteLine($"Subject: {mboxMessageInfo.Subject}");
    Console.WriteLine($"From: {mboxMessageInfo.From}");
    Console.WriteLine($"To: {mboxMessageInfo.To}");
 
    // Extract the full MIME message object from the MBOX storage using the message's unique entry ID.
    var eml = mbox.ExtractMessage(mboxMessageInfo.EntryId, new EmlLoadOptions());
 
    // Save the extracted MIME message as an .eml file.
    eml.Save($"{eml.Subject}.eml");
}

[Visual Basic]

' Create an instance of the MboxStorageReader using the factory method 'CreateReader'.
Dim mbox As MboxStorageReader = MboxStorageReader.CreateReader("storage.mbox", New MboxLoadOptions())
 
' Iterate through each message info object in the mbox storage.
For Each mboxMessageInfo As var In mbox.EnumerateMessageInfo()
    Console.WriteLine($"Subject: {mboxMessageInfo.Subject}")
    Console.WriteLine($"From: {mboxMessageInfo.From}")
    Console.WriteLine($"To: {mboxMessageInfo.To}")
 
    ' Extract the full MIME message object from the MBOX storage using the message's unique entry ID.
    Dim eml As var = mbox.ExtractMessage(mboxMessageInfo.EntryId, New EmlLoadOptions())
 
    ' Save the extracted MIME message as an .eml file.
    eml.Save($"{eml.Subject}.eml")
Next

Constructor & Destructor Documentation

◆ MboxStorageReader() [1/2]

Aspose::Email::Storage::Mbox::MboxStorageReader::MboxStorageReader	(	System::SharedPtr< System::IO::Stream >	stream,
		System::SharedPtr< MboxLoadOptions >	options
	)

protected

Initializes a new instance of the MboxStorageReader class.

Parameters

stream	The stream.
options	additional options when loading a Mbox storageMboxLoadOptions.

Exceptions

ArgumentNullException If given stream is null.

◆ MboxStorageReader() [2/2]

Aspose::Email::Storage::Mbox::MboxStorageReader::MboxStorageReader	(	System::String	fileName,
		System::SharedPtr< MboxLoadOptions >	options
	)

protected

Initializes a new instance of the MboxStorageReader class.

Parameters

fileName	Name of the file.
options	additional options when loading a Mbox storageMboxLoadOptions.

Exceptions

ArgumentNullException If filename is null or empty.

◆ ~MboxStorageReader()

virtual Aspose::Email::Storage::Mbox::MboxStorageReader::~MboxStorageReader ( )

protectedvirtual

Member Function Documentation

◆ ByteArrayStartsFromMarker()

static bool Aspose::Email::Storage::Mbox::MboxStorageReader::ByteArrayStartsFromMarker	(	System::ArrayPtr< uint8_t >	array,
		System::ArrayPtr< uint8_t >	marker
	)

static

Checks whether the array starts from given marker.

Parameters

array	The array, can be null.
marker	The marker, can't be null.

Returns: Boolean value indicating the result of operation.

◆ Cancel()

void Aspose::Email::Storage::Mbox::MboxStorageReader::Cancel ( )

This method used to interrupt a split operation.

◆ ContainsAsctime()

static bool Aspose::Email::Storage::Mbox::MboxStorageReader::ContainsAsctime ( System::ArrayPtr< uint8_t > currentLine )

static

Determines whether the specified line contains asctime string.

Parameters

currentLine The current line.

Returns: true if the specified current line contains asctime; otherwise, false.

◆ CreateReader() [1/2]

static System::SharedPtr<MboxStorageReader> Aspose::Email::Storage::Mbox::MboxStorageReader::CreateReader	(	System::SharedPtr< System::IO::Stream >	stream,
		System::SharedPtr< MboxLoadOptions >	options
	)

static

Creates the instance of reader.

Parameters

stream	The stream.
options	additional options when loading a Mbox storageMboxLoadOptions.

Returns

Exceptions

ArgumentNullException

◆ CreateReader() [2/2]

static System::SharedPtr<MboxStorageReader> Aspose::Email::Storage::Mbox::MboxStorageReader::CreateReader	(	System::String	fileName,
		System::SharedPtr< MboxLoadOptions >	options
	)

static

Creates the instance of reader.

Parameters

fileName
options	additional options when loading a Mbox storageMboxLoadOptions.

Returns

Exceptions

ArgumentNullException

◆ Dispose() [1/2]

void Aspose::Email::Storage::Mbox::MboxStorageReader::Dispose ( )

override

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

◆ Dispose() [2/2]

virtual void Aspose::Email::Storage::Mbox::MboxStorageReader::Dispose ( bool disposing )

protectedvirtual

Releases unmanaged and - optionally - managed resources

Parameters

disposing true to release both managed and unmanaged resources; false to release only unmanaged resources.

◆ EnumerateMessageInfo() [1/3]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MboxMessageInfo> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessageInfo ( )

Exposes the enumerator, which supports an iteration of messages in storage.

Returns: System::Collections::Generic::IEnumerable<T>, that represents an enumerator that iterates through a messages in storage.

◆ EnumerateMessageInfo() [2/3]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MboxMessageInfo> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessageInfo	(	int32_t	startIndex,
		int32_t	count
	)

Enumerates a specified number of message information entries, starting from the given index.

Parameters

startIndex	The zero-based index of the first message to retrieve. If startIndex is greater than or equal to the total number of items, an ArgumentOutOfRangeException is thrown.
count	The maximum number of message information entries to retrieve. If set to -1, all messages from the start index will be read.

Returns: An enumerable collection of MboxMessageInfo instances starting from the specified index. The collection may be empty if there are no messages in the specified range.

Exceptions

ArgumentOutOfRangeException Thrown when startIndex is greater than or equal to the total number of available messages.

◆ EnumerateMessageInfo() [3/3]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MboxMessageInfo> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessageInfo ( System::SharedPtr< Tools::Search::MailQuery > query )

Enumerates the message information that matches the specified query.

Parameters

query The MailQuery used to filter messages.

Returns: An enumerable collection of MboxMessageInfo instances that match the specified query. The collection may be empty if no messages match.

◆ EnumerateMessages() [1/6]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MailMessage> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessages ( )

Exposes the enumerator, which supports an iteration of messages in storage.

Returns: System::Collections::Generic::IEnumerable<T>, that represents an enumerator that iterates through a messages in storage.

◆ EnumerateMessages() [2/6]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MailMessage> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessages	(	int32_t	startIndex,
		int32_t	count
	)

Enumerates a specified number of mail messages, starting from the given index.

Parameters

startIndex	The zero-based index of the first message to retrieve. If startIndex is greater than or equal to the total number of items, an ArgumentOutOfRangeException is thrown.
count	The maximum number of messages to retrieve. If set to -1, all messages from the start index will be read.

Returns: An enumerable collection of MailMessage instances starting from the specified index. The collection may be empty if there are no messages in the specified range.

Exceptions

ArgumentOutOfRangeException Thrown when startIndex is greater than or equal to the total number of available messages.

◆ EnumerateMessages() [3/6]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MailMessage> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessages ( System::SharedPtr< EmlLoadOptions > options )

Exposes the enumerator, which supports an iteration of messages in storage.

Parameters

options Specifies EmlLoadOptions when reading message from Mbox storage.

Returns: System::Collections::Generic::IEnumerable<T>, that represents an enumerator that iterates through a messages in storage.

◆ EnumerateMessages() [4/6]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MailMessage> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessages	(	System::SharedPtr< EmlLoadOptions >	options,
		int32_t	startIndex,
		int32_t	count
	)

Enumerates a specified number of mail messages, starting from the given index, using the provided load options.

Parameters

options	The EmlLoadOptions specifying how EML files should be loaded.
startIndex	The zero-based index of the first message to retrieve. If startIndex is greater than or equal to the total number of items, an ArgumentOutOfRangeException is thrown.
count	The maximum number of messages to retrieve. If set to -1, all messages from the start index will be read.

Returns: An enumerable collection of MailMessage instances starting from the specified index. The collection may be empty if there are no messages in the specified range.

Exceptions

ArgumentOutOfRangeException Thrown when startIndex is greater than or equal to the total number of available messages.

◆ EnumerateMessages() [5/6]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MailMessage> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessages	(	System::SharedPtr< EmlLoadOptions >	options,
		System::SharedPtr< Tools::Search::MailQuery >	query
	)

Enumerates the mail messages that match the specified query, using the provided load options.

Parameters

options	The EmlLoadOptions specifying how EML should be read.
query	The MailQuery used to filter messages.

Returns: An enumerable collection of MailMessage instances that match the specified query. The collection may be empty if no messages match.

◆ EnumerateMessages() [6/6]

System::SharedPtr<System::Collections::Generic::IEnumerable<System::SharedPtr<MailMessage> > > Aspose::Email::Storage::Mbox::MboxStorageReader::EnumerateMessages ( System::SharedPtr< Tools::Search::MailQuery > query )

Enumerates the mail messages that match the specified query.

Parameters

query The MailQuery used to filter messages.

Returns: An enumerable collection of MailMessage instances that match the specified query. The collection may be empty if no messages match.

◆ ExtractMessage()

System::SharedPtr<MailMessage> Aspose::Email::Storage::Mbox::MboxStorageReader::ExtractMessage	(	System::String	id,
		System::SharedPtr< EmlLoadOptions >	options
	)

Get the message from MBOX.

Parameters

id	String representation of EntryId.
options	Specifies EmlLoadOptions when reading message from Mbox storage.

Returns: A MailMessage object.

◆ get_BaseStream()

System::SharedPtr<System::IO::Stream> Aspose::Email::Storage::Mbox::MboxStorageReader::get_BaseStream ( ) const

Gets the base stream.

The base stream.

◆ get_CurrentDataSize()

int64_t Aspose::Email::Storage::Mbox::MboxStorageReader::get_CurrentDataSize ( ) const

Gets the number of bytes that is read by ReadNextMessage method.

◆ GetTotalItemsCount()

virtual int32_t Aspose::Email::Storage::Mbox::MboxStorageReader::GetTotalItemsCount ( )

pure virtual

Returns the number of messages in a storage.

Returns: Returns the number of messages in a storage.

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ GetVentureLicenseState()

VentureLicenseState Aspose::Email::Storage::Mbox::MboxStorageReader::GetVentureLicenseState ( )

◆ NextMessage() [1/2]

virtual System::SharedPtr<MboxMessageInfo> Aspose::Email::Storage::Mbox::MboxStorageReader::NextMessage ( )

pure virtual

Gets the next message info.

Returns: A MboxMessageInfo object if it can be read or null if no more messages are available.

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ NextMessage() [2/2]

virtual System::SharedPtr<MboxMessageInfo> Aspose::Email::Storage::Mbox::MboxStorageReader::NextMessage ( int32_t count )

pure virtual

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ ReadLine()

static System::ArrayPtr<uint8_t> Aspose::Email::Storage::Mbox::MboxStorageReader::ReadLine ( System::SharedPtr< System::IO::Stream > stream )

static

Reads the line from stream.

Parameters

stream The stream.

Returns: The line read.

◆ ReadNextMessage() [1/5]

virtual System::SharedPtr<MailMessage> Aspose::Email::Storage::Mbox::MboxStorageReader::ReadNextMessage ( )

pure virtual

Reads the next message from underlying storage stream.

Returns: A MailMessage object if it can be read or null if no more messages are available.

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ ReadNextMessage() [2/5]

virtual System::SharedPtr<MailMessage> Aspose::Email::Storage::Mbox::MboxStorageReader::ReadNextMessage ( System::SharedPtr< EmlLoadOptions > options )

pure virtual

Reads the next message from underlying storage stream.

Parameters

options Specifies EmlLoadOptions when reading message from Mbox storage.

Returns: A MailMessage object if it can be read or null if no more messages are available.

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ ReadNextMessage() [3/5]

virtual System::SharedPtr<MailMessage> Aspose::Email::Storage::Mbox::MboxStorageReader::ReadNextMessage	(	System::SharedPtr< EmlLoadOptions >	options,
		int32_t	count
	)

pure virtual

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ ReadNextMessage() [4/5]

virtual System::SharedPtr<MailMessage> Aspose::Email::Storage::Mbox::MboxStorageReader::ReadNextMessage ( System::String & fromMarker )

pure virtual

Reads the next message from underlying storage stream.

Parameters

fromMarker Gets the From Marker while parsing the MBox Storage file.

Returns: A MailMessage object if it can be read or null if no more messages are available.

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ ReadNextMessage() [5/5]

virtual System::SharedPtr<MailMessage> Aspose::Email::Storage::Mbox::MboxStorageReader::ReadNextMessage	(	System::String &	fromMarker,
		System::SharedPtr< EmlLoadOptions >	options
	)

pure virtual

Reads the next message from underlying storage stream.

Parameters

fromMarker	Gets the From Marker while parsing the MBox Storage file.
options	Specifies EmlLoadOptions when reading message from Mbox storage.

Returns: A MailMessage object if it can be read or null if no more messages are available.

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ set_CurrentDataSize()

void Aspose::Email::Storage::Mbox::MboxStorageReader::set_CurrentDataSize ( int64_t value )

protected

Gets the number of bytes that is read by ReadNextMessage method.

◆ SetPositionByIndex()

virtual void Aspose::Email::Storage::Mbox::MboxStorageReader::SetPositionByIndex ( int32_t index )

pure virtual

Implemented in Aspose::Email::Storage::Mbox::MboxrdStorageReader, and Aspose::Email::Storage::Mbox::MboxoStorageReader.

◆ SplitInto() [1/2]

void Aspose::Email::Storage::Mbox::MboxStorageReader::SplitInto	(	int64_t	chunkSize,
		System::String	outputPath
	)

Splits the mbox storage into less sized parts.

Parameters

chunkSize	The approximate size of a chunk in bytes.
outputPath	The folder path where chunks will be created.

Exceptions

ArgumentException Throws when the path parameter is null or empty.

◆ SplitInto() [2/2]

void Aspose::Email::Storage::Mbox::MboxStorageReader::SplitInto	(	int64_t	chunkSize,
		System::String	outputPath,
		System::String	partFileNamePrefix
	)

Splits the mbox storage into less sized parts.

Parameters

chunkSize The approximate size of a chunk in bytes.

outputPath The folder path where chunks will be created.

partFileNamePrefix

The prefix to be added to the filename of each part of pst.

Exceptions

ArgumentException Throws when the path parameter is null or empty.

Friends And Related Function Documentation

◆ MboxoStorageReader

friend class MboxoStorageReader

friend

◆ MboxrdStorageReader

friend class MboxrdStorageReader

friend

Member Data Documentation

◆ EmlCopied

System::Event<void(System::SharedPtr<System::Object>, System::SharedPtr<Aspose::Email::Storage::MimeItemCopyEventArgs>)> Aspose::Email::Storage::Mbox::MboxStorageReader::EmlCopied

Event that occurs after successful copy of a MailMessage object within the SplitInto(long, string) method.

◆ EmlCopying

System::Event<void(System::SharedPtr<System::Object>, System::SharedPtr<Aspose::Email::Storage::MimeItemCopyEventArgs>)> Aspose::Email::Storage::Mbox::MboxStorageReader::EmlCopying

Event that occurs before the MailMessage object copy process, within the SplitInto(long, string) method.

◆ EmptyFromMarkerCR

System::ArrayPtr<uint8_t> Aspose::Email::Storage::Mbox::MboxStorageReader::EmptyFromMarkerCR

static

◆ EmptyFromMarkerCRLF

System::ArrayPtr<uint8_t> Aspose::Email::Storage::Mbox::MboxStorageReader::EmptyFromMarkerCRLF

static

◆ EmptyFromMarkerLF

System::ArrayPtr<uint8_t> Aspose::Email::Storage::Mbox::MboxStorageReader::EmptyFromMarkerLF

static

◆ FromMarker

System::ArrayPtr<uint8_t> Aspose::Email::Storage::Mbox::MboxStorageReader::FromMarker

static

"From " signature, indicates a start of the message.

◆ MboxFileCreated

System::Event<void(System::SharedPtr<System::Object>, System::SharedPtr<Aspose::Email::Storage::NewStorageEventArgs>)> Aspose::Email::Storage::Mbox::MboxStorageReader::MboxFileCreated

Event that occurs when a new MBOX file is created during the SplitInto(long, string) method.

◆ MboxFileFilled

System::Event<void(System::SharedPtr<System::Object>, System::SharedPtr<Aspose::Email::Storage::NewStorageEventArgs>)> Aspose::Email::Storage::Mbox::MboxStorageReader::MboxFileFilled

Event that occurs after filling an MBOX file with data within the SplitInto(long, string) method.

◆ MboxoMarker

System::ArrayPtr<uint8_t> Aspose::Email::Storage::Mbox::MboxStorageReader::MboxoMarker

static

The mbox format uses a single blank line followed by the string 'From ' (with a space) to delimit messages. In mboxo format sender's email address in message delimiter is replaced by the constant string '???@???', i.e. 'From ???@???'

◆ msgCount

int32_t Aspose::Email::Storage::Mbox::MboxStorageReader::msgCount

◆ mVentureLicense

System::SharedPtr<System::Object> Aspose::Email::Storage::Mbox::MboxStorageReader::mVentureLicense

◆ preferredTextEncoding

System::SharedPtr<System::Text::Encoding> Aspose::Email::Storage::Mbox::MboxStorageReader::preferredTextEncoding

protected

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ MboxStorageReader() [1/2]

◆ MboxStorageReader() [2/2]

◆ ~MboxStorageReader()

Member Function Documentation

◆ ByteArrayStartsFromMarker()

◆ Cancel()

◆ ContainsAsctime()

◆ CreateReader() [1/2]

◆ CreateReader() [2/2]

◆ Dispose() [1/2]

◆ Dispose() [2/2]

◆ EnumerateMessageInfo() [1/3]

◆ EnumerateMessageInfo() [2/3]

◆ EnumerateMessageInfo() [3/3]

◆ EnumerateMessages() [1/6]

◆ EnumerateMessages() [2/6]

◆ EnumerateMessages() [3/6]

◆ EnumerateMessages() [4/6]

◆ EnumerateMessages() [5/6]

◆ EnumerateMessages() [6/6]

◆ ExtractMessage()

◆ get_BaseStream()

◆ get_CurrentDataSize()

◆ GetTotalItemsCount()

◆ GetVentureLicenseState()

◆ NextMessage() [1/2]

◆ NextMessage() [2/2]

◆ ReadLine()

◆ ReadNextMessage() [1/5]

◆ ReadNextMessage() [2/5]

◆ ReadNextMessage() [3/5]

◆ ReadNextMessage() [4/5]

◆ ReadNextMessage() [5/5]

◆ set_CurrentDataSize()

◆ SetPositionByIndex()

◆ SplitInto() [1/2]

◆ SplitInto() [2/2]

Friends And Related Function Documentation

◆ MboxoStorageReader

◆ MboxrdStorageReader

Member Data Documentation

◆ EmlCopied

◆ EmlCopying

◆ EmptyFromMarkerCR

◆ EmptyFromMarkerCRLF

◆ EmptyFromMarkerLF

◆ FromMarker

◆ MboxFileCreated

◆ MboxFileFilled

◆ MboxoMarker

◆ msgCount

◆ mVentureLicense

◆ preferredTextEncoding