EwsDownloadItemIds Method (FolderId, ItemView, Boolean)
Downloads IDs of items in the specified folder in the specified ItemView range.

Namespace: MailBee.EwsMail
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.2.0 build 630 for .NET 4.5
public EwsItemList DownloadItemIds(
	FolderId id,
	ItemView view,
	bool unreadOnly


Type: FolderId
The ID of the folder. Null reference (Nothing in Visual Basic) not allowed.
Type: ItemView
The settings which specify how many items to download, offset, and ordering. If a null reference, all the matching items are downloaded.
Type: SystemBoolean
If true, only unread items are considered for download; otherwise, all the items.

Return Value

Type: EwsItemList
The list of EwsItem items with Id property set, 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.

Usually, you'll immediately pass the returned list to a method like DownloadItems(IEnumerableEwsItem, EwsItemParts). However, once you downloaded the item IDs, you can also store UniqueId values elsewhere and later recreate EwsItem objects from that strings using EwsItem(String) constructor.

Items are returned in the default sorting order which usually means "newer first" in Exchange. This is different from IMAP and POP3, where "older first" is the default.

Note Note
In the returned collection of EwsItem objects, you can access their Id and UniqueId properties only. Accessing other properties will cause an exception (because only ID was loaded for each item).
Note Note
This method is not implemented in .NET Core. Use DownloadItemIdsAsync(FolderId, ItemView, Boolean) instead.
See Also