Begins asynchronous StoreRawMessage operation. Uploads the contents of the stream to the specified folder and sets its flags and date.

Namespace:  Rebex.Net
Assembly:  Rebex.Imap (in Rebex.Imap.dll)

Syntax

Visual Basic
Public Function BeginStoreRawMessage ( _
	folder As String, _
	input As Stream, _
	flags As ImapMessageFlags, _
	internalDate As MailDateTime, _
	callback As AsyncCallback, _
	state As Object _
) As IAsyncResult
C#
public IAsyncResult BeginStoreRawMessage(
	string folder,
	Stream input,
	ImapMessageFlags flags,
	MailDateTime internalDate,
	AsyncCallback callback,
	Object state
)

Parameters

folder
Type: System..::..String
Folder that will receive the message.
input
Type: System.IO..::..Stream
The input stream.
flags
Type: Rebex.Net..::..ImapMessageFlags
Message flags.
internalDate
Type: Rebex.Mime.Headers..::..MailDateTime
IMAP message date/time.
callback
Type: System..::..AsyncCallback
An optional asynchronous callback to be called when the operation is complete.
state
Type: System..::..Object
A user-provided object that identifies this particular asynchronous operation.

Return Value

An IAsyncResult that references the asynchronous operation.

Remarks

Caution: Unlike the StoreMessage methods, StoreRawMessage does not parse the message to validate its structure and retrieve its date/time. User must ensure the stream supplied to this method represents a valid MIME format message.

The stream must contain data in MIME format, other formats are not supported. MIME files often have the '.eml' extension and are produced by Outlook Express. In contrast, Outlook produces '.msg' files that are not MIME files and therefore cannot be uploaded using this method.

This method represents IMAP APPEND command.

Unique ID of the message will be returned if the server supports the ImapExtensions.UniqueIdPlus extension and it is enabled. See SupportedExtensions and EnabledExtensions.

In builds for .NET 4.0 and higher, this method is available as an extension method. Add 'using Rebex.Legacy' (C#) or 'Import Rebex.Legacy' (VB.NET) to your code in order to use it.

Version Information

.NET Compact Framework

Supported in: 3.9, 3.5

See Also