UpdateItemUpdateItem

UpdateItem元素定义一个请求以更新邮箱中的项目。The UpdateItem element defines a request to update an item in a mailbox.

<UpdateItem ConflictResolution="" MessageDisposition="" SendMeetingInvitationsOrCancellations="" SuppressReadReceipts="">
   <SavedItemFolderId/>
   <ItemChanges/>
</UpdateItem>

UpdateItemTypeUpdateItemType

属性和元素Attributes and elements

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

AttributesAttributes

属性Attribute 说明Description
ConflictResolutionConflictResolution
标识在更新过程中要尝试的冲突解决的类型。Identifies the type of conflict resolution to try during an update. 默认值为 "自动解析"。The default value is AutoResolve.
MessageDispositionMessageDisposition
介绍如何在更新项目后对其进行处理。Describes how the item will be handled after it is updated. 邮件项目(包括会议邮件(如会议取消、会议请求和会议响应)需要MessageDisposition属性。The MessageDisposition attribute is required for message items, including meeting messages such as meeting cancellations, meeting requests, and meeting responses.
SendMeetingInvitationsOrCancellationsSendMeetingInvitationsOrCancellations
介绍如何在更新日历项目后传达会议更新。Describes how meeting updates are communicated after a calendar item is updated. 此属性是日历项目和日历项目发生的必要条件。This attribute is required for calendar items and calendar item occurrences.
SuppressReadReceiptsSuppressReadReceipts
指示是否应禁止显示已更新项目的已读回执。Indicates whether read receipts for the updated item should be suppressed. 如果文本值为 true,则表示应禁止显示已读回执。A text value of true indicates that read receipts should be suppressed. 如果值为 false ,则表示已将已读回执发送给发件人。A value of false indicates that the read receipts will be sent to the sender. 此特性是可选的。This attribute is optional.
此属性是在 Exchange Server 2013 SP1 中引入的。This attribute was introduced in Exchange Server 2013 SP1.

ConflictResolution 属性ConflictResolution Attribute

Value 说明Description
NeverOverwriteNeverOverwrite
如果存在冲突,更新操作将失败并返回错误。If there is a conflict, the update operation fails and an error is returned.
解决AutoResolve
更新操作将自动解决任何冲突。The update operation automatically resolves any conflict.
AlwaysOverwriteAlwaysOverwrite
如果存在冲突,更新操作将覆盖信息。If there is a conflict, the update operation will overwrite information.

MessageDisposition 属性MessageDisposition Attribute

Value 说明Description
SaveOnlySaveOnly
更新项目并将其保存回其当前文件夹。The item is updated and saved back to its current folder.
SendOnlySendOnly
更新并发送项目,但不保存副本。The item is updated and sent but no copy is saved.
SendAndSaveCopySendAndSaveCopy
更新项目并将副本保存在由SavedItemFolderId元素标识的文件夹中。The item is updated and a copy is saved in the folder identified by the SavedItemFolderId element.

SendMeetingInvitationsOrCancellations 属性SendMeetingInvitationsOrCancellations Attribute

Value 说明Description
SendToNoneSendToNone
日历项目已更新,但未将更新发送给与会者。The calendar item is updated but updates are not sent to attendees.
SendOnlyToAllSendOnlyToAll
将更新日历项目并将会议更新发送给所有与会者,但不会将其保存在 "已发送邮件" 文件夹中。The calendar item is updated and the meeting update is sent to all attendees but is not saved in the Sent Items folder.
SendOnlyToChangedSendOnlyToChanged
将更新日历项目,并且仅向受会议更改影响的与会者发送会议更新。The calendar item is updated and the meeting update is sent only to attendees that are affected by the change in the meeting.
SendToAllAndSaveCopySendToAllAndSaveCopy
更新日历项目,将会议更新发送给所有与会者,并将副本保存在 "已发送邮件" 文件夹中。The calendar item is updated, the meeting update is sent to all attendees, and a copy is saved in the Sent Items folder.
SendToChangedAndSaveCopySendToChangedAndSaveCopy
更新日历项目,将会议更新发送给受会议更改影响的所有与会者,并将副本保存在 "已发送邮件" 文件夹中。The calendar item is updated, the meeting update is sent to all attendees that are affected by the change in the meeting, and a copy is saved in the Sent Items folder.

子元素Child elements

元素Element 描述Description
SavedItemFolderIdSavedItemFolderId
标识在 Exchange 存储中更新、发送和创建项目的操作的目标文件夹。Identifies the target folder for operations that update, send, and create items in the Exchange store.
ItemChangesItemChanges
包含标识项目和要应用于项目的更新的ItemChange元素的数组。Contains an array of ItemChange elements that identify items and the updates to apply to the items.

父元素Parent elements

无。None.

说明Remarks

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

元素信息Element information

命名空间Namespace
https://schemas.microsoft.com/exchange/services/2006/messages
架构名称Schema Name
消息架构Messages schema
验证文件Validation File
Messages.xsdMessages.xsd
可以为空Can be Empty
FalseFalse

另请参阅See also

UpdateItem 操作UpdateItem operation