MessageDispositionType enumeration
The Exchange Web Services (EWS) autogenerated proxy object models that are created by .NET Framework proxy generators are deemphasized and we do not recommend that you use them for new .NET Framework client development. We recommend that you use the EWS Managed API to develop clients that target the .NET Framework. We recommend that you use the EWS Java API to develop clients that target the Java platform. For more information about the EWS Managed API, see Explore the EWS Managed API.
The MessageDispositionType enumeration specifies how a message item is handled after it is created or updated.
Assembly: EWS (in EWS.dll)
| Member name | Description | |
|---|---|---|
| SaveOnly | When used in the CreateItemType, the e-mail message item is saved in the folder that is specified by the SavedItemFolderId property, or in the Sent Items folder if SavedItemFolderId is not specified. Messages can be sent later by using the SendItem method on an ExchangeServiceBinding object. An item identifier is returned in this case. When used in the UpdateItemType, the item is updated and saved back to its current folder. | |
| SendOnly | When used in the CreateItemType, the e-mail message item is sent but no copy is saved. An item identifier is not returned in this case. When used in the UpdateItemType, the item is sent but no copy is saved. | |
| SendAndSaveCopy | When used in the CreateItemType, the e-mail message item is sent and a copy is saved in the folder that is specified by the SavedItemFolderId property, or in the Sent Items folder if SavedItemFolderId is not specified. An item identifier is not returned in this case. When used in the UpdateItemType, the item is updated and a copy is saved in the folder that is identified by the SavedItemFolderId property. |
When the MessageDispositionType is used for the CreateItemType, it only applies to e-mail messages. When the MessageDispositionType is used for the UpdateItemType type, it can apply to e-mail messages and meeting messages, including meeting cancellations, meeting requests, and meeting responses. This enumeration is not used for response objects.
CreateItem responses return an ItemId when MessageDispositionType is set to SaveOnly.
