EwsDownloadItem Method (FolderId, Int32, PropertySet)
Downloads an item in the specified folder at the specified index using PropertySet settings.

Namespace: MailBee.EwsMail
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.2.0 build 630 for .NET 4.5
public EwsItem DownloadItem(
	FolderId id,
	int index,
	PropertySet properties


Type: FolderId
The ID of the folder. Null reference (Nothing in Visual Basic) not allowed.
Type: SystemInt32
The zero-based index of the message to be downloaded.
Type: PropertySet
The settings which specify which portions of an MS Exchange item to download (e.g. item ID, mail header, body, etc). If a null reference, only item ID is requested.

Return Value

Type: EwsItem
The item in the given folder, or a null reference (Nothing in Visual Basic) on error.
MailBeeExceptionAn error occurred and ThrowExceptions is true.
NotImplementedExceptionThe .NET runtime is .NET Core.

To specify the folder by its name, first get its ID with FindFolderIdByShortName(FolderId, String) or FindFolderIdByFullName(String) method.

This is advanced overload which lets you request item parts in the native way of Exchange EWS (via PropertySet obejct). If you just want to dowload a full message with attachments, use DownloadItem(FolderId, Int32, EwsItemParts) overload and pass MailMessageFull as parts parameter value.

Note Note
In EWS, message indices start from 0 while in IMAP and POP3 they start from 1. Also, the default sorting order in Exchange is "newer first". In IMAP/POP3, "older first" is the default.
Note Note
This method is not implemented in .NET Core. Use DownloadItemAsync(FolderId, Int32, PropertySet) instead.
See Also