Imap.StoreRawMessageAsync Method
Namespace: Rebex.Net
Assembly: Rebex.Imap.dll (version 7.0.9083)
StoreRawMessageAsync(String, Stream, ImapMessageFlags, MailDateTime, String[], Object)
Begins asynchronous StoreRawMessage operation. Uploads the contents of the stream to the specified folder and sets its flags and date.
Declaration
public Task<string> StoreRawMessageAsync(string folder, Stream input, ImapMessageFlags flags, MailDateTime internalDate, string[] keywords, object state = null)Parameters
| Type | Name | Description |
|---|---|---|
| String | folder | Folder that will receive the message. |
| Stream | input | The input stream. |
| ImapMessageFlags | flags | Message flags. |
| MailDateTime | internalDate | IMAP message date/time. |
| String[] | keywords | Keywords to set. |
| Object | state | An optional user-provided object that identifies this particular asynchronous operation. |
Returns
| Type | Description |
|---|---|
| Task<String> | Unique ID of the message, or null (Nothing in Visual Basic) if the server does not support the UIDPLUS extension. |
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.