DeleteItemDeleteItem

DeleteItem元素定义一个请求,以从 Exchange 存储中的邮箱中删除项目。The DeleteItem element defines a request to delete an item from a mailbox in the Exchange store.

<DeleteItem DeleteType="" SendMeetingCancellations="" AffectedTaskOccurrences="" SuppressReadReceipts="">
   <ItemIds/>
</DeleteItem>

DeleteItemTypeDeleteItemType

属性和元素Attributes and elements

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

AttributesAttributes

属性Attribute 说明Description
DeleteTypeDeleteType
介绍如何删除项目。Describes how an item is deleted. 此特性是必需的。This attribute is required.
SendMeetingCancellationsSendMeetingCancellations
描述是否将日历项目删除操作传递给与会者。Describes whether a calendar item deletion is communicated to attendees. 删除日历项目时,此属性是必需的。This attribute is required when calendar items are deleted. 如果删除非日历项目,则此属性是可选的。This attribute is optional if non-calendar items are deleted.
AffectedTaskOccurrencesAffectedTaskOccurrences
描述任务实例或任务主控形状是否由DeleteItem 操作删除。Describes whether a task instance or a task master is deleted by a DeleteItem operation. 删除任务时,此属性是必需的。This attribute is required when tasks are deleted. 当非任务项目被删除时,此属性是可选的。This attribute is optional when non-task items are deleted.
SuppressReadReceiptsSuppressReadReceipts
指示是否禁止显示已删除项目的已读回执。Indicates whether read receipts for the deleted item are suppressed. 如果文本值为true,则表示已取消阅读回执。A text value of true, indicates that the read receipts are suppressed. 如果值为 false ,则表示已将已读回执发送到发件人。A value of false indicates that the read receipts are sent to the sender. 此特性是可选的。This attribute is optional.

DeleteType 属性DeleteType attribute

Value 说明Description
HardDeleteHardDelete
项目已从存储区中永久删除。An item is permanently removed from the store.
SoftDeleteSoftDelete
如果启用了转储程序,则会将项目移动到转储程序。An item is moved to the dumpster if the dumpster is enabled.
MoveToDeletedItemsMoveToDeletedItems
将项目移动到"已删除邮件"文件夹中。An item is moved to the Deleted Items folder.

SendMeetingCancellations 属性SendMeetingCancellations attribute

Value 说明Description
SendToNoneSendToNone
删除日历项目,但不发送取消邮件。A calendar item is deleted without sending a cancellation message.
SendOnlyToAllSendOnlyToAll
删除日历项目并向所有与会者发送取消邮件。A calendar item is deleted and a cancellation message is sent to all attendees.
SendToAllAndSaveCopySendToAllAndSaveCopy
删除日历项目并向所有与会者发送取消邮件。A calendar item is deleted and a cancellation message is sent to all attendees. 取消邮件的副本保存在 "已发送邮件" 文件夹中。A copy of the cancellation message is saved in the Sent Items folder.

AffectedTaskOccurrences 属性AffectedTaskOccurrences attribute

Value 说明Description
AllOccurrencesAllOccurrences
"删除项目" 请求会删除主任务,从而删除与主任务相关联的所有定期任务。A delete item request deletes the master task, and therefore all recurring tasks that are associated with the master task.
SpecifiedOccurrenceOnlySpecifiedOccurrenceOnly
"删除项目" 请求仅删除任务的特定事件。A delete item request deletes only specific occurrences of a task.

子元素Child elements

元素Element 描述Description
ItemIdsItemIds
包含要从 Exchange 存储中的邮箱中删除的项、具体值项和定期主项目的数组。Contains an array of items, occurrence items, and recurring master items to delete from a mailbox in the Exchange store. 可以对任何项目类型执行DeleteItem 操作The DeleteItem operation can be performed on any item type.

父元素Parent elements

无。None.

说明Remarks

MoveToDeletedItemsHardDelete 选项是事务性的这意味着,Web 服务调用完成时,数据库将邮件移至已删除邮件文件夹或从Exchange数据库中永久删除该项目。这种行为是相同的MicrosoftExchange Server 2007和Exchange Server 2010。The MoveToDeletedItems and HardDelete options are transactional, which means that by the time a Web service call completes, the database has moved the item to the Deleted Items folder or permanently removed the item from the Exchange database. This behavior is the same for MicrosoftExchange Server 2007 and Exchange Server 2010.

Exchange 的不同目标版本的SoftDelete选项的工作方式不同。The SoftDelete option works differently for different target versions of Exchange. SoftDelete for exchange 2007 在项目中设置一个位,以指示 exchange 数据库,该项目将在将来的不确定时间移动到转储程序文件夹中。SoftDelete for Exchange 2007 sets a bit on the item that indicates to the Exchange database that the item will be moved to the dumpster folder at an indeterminate time in the future. SoftDelete for Exchange 2010 立即将项目移动到转储程序。SoftDelete for Exchange 2010 immediately moves the item to the dumpster. SoftDelete不是文件夹删除的选项。SoftDelete is not an option for folder deletion. SoftDelete遍历项目和文件夹的搜索不会返回任何结果。SoftDelete traversal searches for items and folders will not return any results.

描述此元素的架构位于承载 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