Artikel
08/21/2009

CreateItem

Topic Last Modified: 2008-06-10

The CreateItem element defines a request to create an item in the Exchange store.

Syntax

<CreateItem MessageDisposition="" SendMeetingInvitations="">
   <SavedItemFolderId/>
   <Items/>
</CreateItem>

Type

CreateItemType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
MessageDisposition	Describes how the item will be handled after it is created. The attribute is required for e-mail messages. This attribute is only applicable to e-mail messages.
SendMeetingInvitations	Describes how meeting requests are handled after they are created. This attribute is required for calendar items.

MessageDisposition Attribute

Value	Description
SaveOnly	The message item is saved in the folder that is specified by the SavedItemFolderId element. Messages can be sent later by using the SendItem Operation. An item identifier is returned in the response. Item identifiers are not returned for any item types except for message items. This includes response objects.
SendOnly	The item is sent but no copy is saved in the Sent Items folder. An item identifier is not returned in the response. Note: CreateItem does not support delegate access when the SendOnly option is used because a destination folder cannot be specified with this option. The workaround is to create the item, get the item identifier, and then use the SendItem operation to send the item.
SendAndSaveCopy	The item is sent and a copy is saved in the folder that is identified by the SavedItemFolderId element. An item identifier is not returned in the response. Note: Meeting requests are not saved to the folder that is identified by the SavedItemFolderId property. For calendaring, only the save location for calendar items can be specified by the SavedItemFolderId property. You cannot control where a meeting request item is saved. Only the associated calendar items are copied and saved into the folder that is identified by the SavedItemFolderId property.

SendMeetingInvitations Attribute

Value	Description
SendToNone	If the item is a meeting request, it is saved as a calendar item but not sent.
SendOnlyToAll	The meeting request is sent to all attendees but is not saved in the Sent Items folder.
SendToAllAndSaveCopy	The meeting request is sent to all attendees and a copy is saved in the folder that is identified by the SavedItemFolderId element.

Child Elements

Element	Description
SavedItemFolderId	Identifies the target folder where a new item can be created. If the MessageDisposition attribute is set to SendOnly, a created message will only be sent. The message will not be put in the folder that is identified by the SavedItemFolderId element.
Items (CreateItem)	Contains an array of items to create in the folder that is identified by the SavedItemFolderId element.

Parent Elements

None.

Remarks

The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Element Information

Namespace	https://schemas.microsoft.com/exchange/services/2006/messages
Schema Name	Messages schema
Validation File	Messages.xsd
Can be Empty	False

Dela via