Item (UploadItemType)Item (UploadItemType)

Item元素代表要上传到邮箱中的单个项目。The Item element represents a single item to upload into a mailbox.

UploadItemsUploadItems

项目(NonEmptyArrayOfUploadItemsType)Items (NonEmptyArrayOfUploadItemsType)

Item (UploadItemType)Item (UploadItemType)

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

UploadItemTypeUploadItemType

属性和元素Attributes and elements

下面各部分介绍了属性、子元素和父元素。The following sections describe attributes, child elements, and parent elements.

AttributesAttributes

属性Attribute 说明Description
CreateActionCreateAction
指定用于将项目上载到邮箱的操作。Specifies the action for uploading an item into a mailbox. 此特性是必需的。This attribute is required.
IsAssociatedIsAssociated
指定上传的项目是否是与文件夹相关联的项目。Specifies whether the uploaded item is a folder associated item. 此属性是一个布尔值。This attribute is a Boolean value. 如果值为 true ,则表示该项目是一个与文件夹相关联的项目。A value of true indicates that the item is a folder associated item. 此特性是可选的。This attribute is optional.

CreateAction 属性CreateAction Attribute

Value 说明Description
CreateNewCreateNew
指示将原始项目的新副本上载到邮箱。Indicates that a new copy of the original item is uploaded to the mailbox. 如果使用了 CreateNew 值,则必须不存在ItemId元素。The ItemId element must not be present if the CreateNew value is used. 在响应中返回新的项目标识符。The new item identifier is returned in the response.
更新Update
指定由ItemId元素指示的项目将更新。Specifies that the item indicated by the ItemId element will be updated. 如果ItemId元素不存在或项目不存在于由ParentFolderId元素标识的文件夹中,则会返回错误。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.
UpdateOrCreateUpdateOrCreate
指示第一次尝试更新项目。Indicates that an attempt is first made to update the item. 如果ParentFolderId元素指定的文件夹中不存在该项目,则会创建一个新项目。If the item does not exist in the folder specified by the ParentFolderId element, a new item is created.

子元素Child elements

元素Element 描述Description
ParentFolderIdParentFolderId
表示在其中创建新项目或包含要更新的项目的父文件夹的标识符。Represents the identifier of the parent folder where a new item is created or that contains the item to update.
ItemIdItemId
包含要在 Exchange 存储中创建或更新的项目的唯一标识符和更改密钥。Contains the unique identifier and change key of an item to create or update in the Exchange store.
Data (base64Binary)Data (base64Binary)
包含要上传到邮箱中的单个项目的数据。Contains the data of a single item to upload into a mailbox.

父元素Parent elements

元素Element 描述Description
项目(NonEmptyArrayOfUploadItemsType)Items (NonEmptyArrayOfUploadItemsType)
包含要上载到邮箱的项的数组。Contains an array of item to upload into a mailbox.

文本值Text value

无。None.

说明Remarks

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。Exchange Server 2010 Service Pack 1 (SP1) 中引入了此元素。The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.This element was introduced in 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.xsdTypes.xsd
可以为空Can be Empty
FalseFalse

另请参阅See also

ExportItems 操作ExportItems operation

UploadItems 操作UploadItems operation