Partager via


Item (UploadItemType)

Last modified: September 28, 2010

Applies to: Exchange Server 2007 | Exchange Server 2010

The Item element represents a single item to upload into a mailbox.

UploadItems
  Items (NonEmptyArrayOfUploadItemsType)
    Item (UploadItemType)

<Item CreateAction="" IsAssociated="">
   <ParentFolderId/>
   <ItemId/>
   <Data/>
</Item>

UploadItemType

Attributes and Elements

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

Attributes

Attribute

Description

CreateAction

Specifies the action for uploading an item into a mailbox. This attribute is required.

IsAssociated

Specifies whether the uploaded item is a folder associated item. This attribute is a Boolean value. A value of true indicates that the item is a folder associated item. This attribute is optional.

CreateAction Attribute

Value

Description

CreateNew

Indicates that a new copy of the original item is uploaded to the mailbox. The ItemId element must not be present if the CreateNew value is used. The new item identifier is returned in the response.

Update

Specifies that the item indicated by the ItemId element will be updated. An error is returned if the ItemId element is not present or if the item does not exist in the folder identified by the ParentFolderId element.

UpdateOrCreate

Indicates that an attempt is first made to update the item. If the item does not exist in the folder specified by the ParentFolderId element, a new item is created.

Child Elements

Element

Description

ParentFolderId

Represents the identifier of the parent folder where a new item is created or that contains the item to update.

ItemId

Contains the unique identifier and change key of an item to create or update in the Exchange store.

Data (base64Binary)

Contains the data of a single item to upload into a mailbox.

Parent Elements

Element

Description

Items (NonEmptyArrayOfUploadItemsType)

Contains an array of item to upload into a mailbox.

Text Value

None.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services of the Client Access server.This element was introduced in Microsoft Exchange Server 2010 Service Pack 1 (SP1).

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/types

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False