Excluir itens usando o EWS no ExchangeDeleting items by using EWS in Exchange

Descubra como você pode usar a API gerenciada do EWS ou o EWS no Exchange para excluir itens movendo-os para a pasta itens excluídos ou para o dumpster.Find out how you can use the EWS Managed API or EWS in Exchange to delete items either by moving them to the Deleted Items folder or to the dumpster.

Você já se perguntou qual é a diferença entre mover itens para a pasta itens excluídos e movê-los para o dumpster?Have you ever asked yourself what the difference is between moving items to the Deleted Items folder, and moving them to the dumpster? Você pode estar curioso sobre as diferentes opções para manipular itens excluídos e como implementar essas opções em seu aplicativo.You might be curious about the different options for handling deleted items and how to implement those options in your application. Os serviços Web do Exchange (EWS) incluem três opções para lidar com itens excluídos.Exchange Web Services (EWS) includes three options for handling deleted items. Neste artigo, esperorá qualquer confusão que você possa ter sobre as diferenças entre eles.This article will hopefully clear up any confusion you might have about the differences between them.

Excluindo itens-quais são as minhas opções?Deleting items - what are my options?

Para que você possa entender o panorama geral da exclusão de itens, é importante reconhecer a diferença entre o seguinte:Before you can understand the overall landscape for deleting items, it's important to recognize the difference between the following:

  • A pasta itens excluídos-quando você exclui itens em uma caixa de correio, é aí que eles vão.The Deleted Items folder - When you delete items in a mailbox, this is where they go.

  • O dumpster (aka a pasta itens recuperáveis)-quando você remove itens de uma caixa de correio, é aí que eles vão.The dumpster (aka the Recoverable Items folder) - When you remove items from a mailbox, this is where they go.

As figuras 1 e 2 mostram a aparência do processo de exclusão para itens e pastas em uma caixa de correio.Figures 1 and 2 show what the deletion process looks like for items and folders in a mailbox.

Figura 1. Processo para excluir itens de uma caixa de correioFigure 1. Process for deleting items from a mailbox

Uma ilustração que mostra para onde os itens vão quando são excluídos.


Figura 2. Processo para excluir pastas de uma caixa de correioFigure 2. Process for deleting folders from a mailbox

Uma ilustração que mostra como pastas excluídas são movidas para a pasta Itens Excluídos e, em seguida, podem ser permanentemente excluídas da caixa de correio.

Você pode excluir itens e pastas de três maneiras diferentes, dependendo de como "permanente" você deseja que a exclusão seja.You can delete items and folders three different ways, depending on how "permanent" you would like the deletion to be.

Tabela 1: opções para excluir itens usando o EWSTable 1: Options for deleting items by using EWS

OpçãoOption O que aconteceWhat happens
Mover para a pasta Itens ExcluídosMove to the Deleted Items folder
Esta é a maneira menos permanente de excluir itens.This is the least permanent way to delete items.

Isso é como colocar uma folha de papel na lixeira de sua mesa.This is like putting a piece of paper in the recycle bin by your desk. Você pode facilmente confazê-la se precisar dela novamente.You can easily grab it if you need it again.

Você pode usar qualquer operação de exclusão que implemente a opção mover para a pasta itens excluídos para executar essa ação.You can use any deletion operation that implements the move to the Deleted Items folder option to perform this action.

Você também pode usar a operação MoveItem ( Item. Move ()) ou a operação MoveFolder ( Folder. Move ()) para mover um item ou pasta para a pasta itens excluídos.You can also use the MoveItem operation ( Item.Move()) or the MoveFolder operation ( Folder.Move()) to move an item or folder to the Deleted Items folder.
Exclusão reversívelSoft delete
O item é movido para a pasta exclusões no dumpster.The item is moved to the Deletions folder in the dumpster.

Isso é como esvaziar sua lixeira no contêiner do Curbside.This is like emptying your recycle bin into your curbside container. Você ainda pode acessar o item, se precisar, é apenas um pouco mais difícil.You can still access the item if you need to, it's just a little harder.

Para saber mais sobre o dumpster (também chamado de itens recuperáveis) e cenários como eDiscovery ou isenções de litígio, confira pasta itens recuperáveis no TechNet.For more about the dumpster (also called the Recoverable Items folder) and scenarios such as eDiscovery or litigation holds, see Recoverable Items Folder on TechNet.

As exclusões suaves não são recomendadas para aplicativos direcionados para o Exchange 2007.Soft deletions aren't recommended for applications that target Exchange 2007. No Exchange 2007, as exclusões suaves são tratadas Configurando um bit no item para indicar que ele será movido para o dumpster em um horário não especificado.In Exchange 2007, soft deletions are handled by setting a bit on the item to indicate that it will be moved to the dumpster at an unspecified time.

Exclusões de exclusão reversível ou pesquisas de itens que foram excluídos de forma reversível por meio da operação FindItem, não são compatíveis com o Exchange Online, o Exchange Online como parte do Office 365 e versões do Exchange a partir do Exchange 2010.Soft delete traversals, or searches of items that have been soft deleted via the FindItem operation, are not supported in Exchange Online, Exchange Online as part of Office 365, and versions of Exchange starting with Exchange 2010.

Observação: pastas não podem ser excluídas de forma reversível.NOTE: Folders cannot be soft deleted.
Exclusão irreversívelHard delete
O item ou pasta é excluído permanentemente.The item or folder is permanently deleted.

Os itens excluídos por hardware são colocados na pasta limpezas do dumpster.Hard-deleted items are placed in the Purges folder of the dumpster. Isso é como quando o caminhão de reciclagem esvazia o contêiner de reciclagem do Curbside.This is like when the recycling truck empties your curbside recycle container. Os itens não podem ser acessados de um cliente de email como o Outlook ou o Outlook Web App e, a menos que haja uma retenção definida na caixa de correio, os itens serão excluídos permanentemente após um determinado período de tempo.The items cannot be accessed from an email client like Outlook or Outlook Web App, and, unless there is a hold set on the mailbox, the items will be permanently deleted after a set period of time.

Você pode ler mais sobre a retenção de itens no artigo configurar cotas de itens recuperáveis e retenção de item excluído.You can read more about item retention in the article Configure Deleted Item Retention and Recoverable Items Quotas.

Observação: as pastas não são colocadas na pasta limpezas quando são excluídas.NOTE: Folders are not placed in the Purges folder when they are hard deleted. As pastas excluídas por hardware são removidas da caixa de correio.Hard-deleted folders are removed from the mailbox.

A movimentação para a pasta itens excluídos e as opções de exclusão de hardware são transacionais, o que significa que, quando a chamada do serviço Web é concluída, o item foi movido para a pasta itens excluídos ou o dumpster.The move to the Deleted Items folder and the hard delete options are transactional, which means that by the time the web service call finishes, the item has been moved to the Deleted Items folder or the dumpster.

Para ajudá-lo a entender melhor o ecossistema de pastas usadas para armazenar itens excluídos, a figura a seguir mostra a hierarquia de pastas que podem conter itens excluídos.To help you better understand the ecosystem of folders that are used to store deleted items, the following figure shows the hierarchy of folders that can contain deleted items. Os nomes de pasta são como aparecem no tipo de esquema DistinguishedFolderIdNameType ou a enumeração WellKnownFolderName na API gerenciada do EWS.The folder names are as they appear in the DistinguishedFolderIdNameType schema type, or the WellKnownFolderName enumeration in the EWS Managed API.

Figura 3. Hierarquia de pastas que contêm itens excluídosFigure 3. Hierarchy of folders that contain deleted items

Uma figura que mostra a hierarquia de pastas que podem conter itens excluídos em uma caixa de correio primária e de arquivamento. Cada pasta na imagem é representada por seu nome de pasta distinto.

Tabela 2: pastas que contêm itens excluídosTable 2: Folders that contain deleted items

Nome da pastaFolder name Introduzido noIntroduced in DescriçãoDescription
deleteditemsdeleteditems
Exchange 2007Exchange 2007
A pasta itens excluídos padrão.The default Deleted Items folder. Os itens permanecem nessa pasta até que sejam Soft-ou discos excluídos ou até que um período de retenção tenha sido excedido.Items remain in this folder until they are soft- or hard-deleted or until a retention period has been exceeded. Em seguida, eles são movidos para uma pasta no dumpster.Then they are moved to a folder in the dumpster. As pastas excluídas são colocadas na pasta itens excluídos e, quando são removidas ou impróprias, elas são excluídas permanentemente da caixa de correio e não são recuperáveis.Deleted folders are placed in the Deleted Items folder, and when they are soft- or hard-deleted, they are permanently removed from the mailbox and are not recoverable.
recoverableitemsrootrecoverableitemsroot
Exchange 2010Exchange 2010
A raiz do dumpster ou da pasta itens recuperáveis.The root of the dumpster, or the Recoverable Items folder. O acesso ao dumpster foi implementado no EWS no Exchange 2010.Dumpster access was implemented in EWS in Exchange 2010. O nome para exibição dessa pasta é "itens recuperáveis".The display name for this folder is "Recoverable Items".
recoverableitemsdeletionsrecoverableitemsdeletions
Exchange 2010Exchange 2010
A pasta de dumpster principal de uma caixa de correio.The main dumpster folder for a mailbox. Itens excluídos por software e itens movidos da pasta itens excluídos por uma política de retenção são colocados nessa pasta.Soft-deleted items and items moved from the Deleted Items folder by a retention policy are placed in this folder. O nome de exibição dessa pasta é "exclusões".The display name for this folder is "Deletions".
recoverableitemsversionsrecoverableitemsversions
Exchange 2010Exchange 2010
Onde as versões mais antigas de um item são armazenadas.Where older versions of an item are stored. Versões antigas de um item são criadas quando um item é atualizado.Old versions of an item are created when an item is updated. Versões de item de rascunho não são salvas nesta pasta.Draft item versions are not saved to this folder. O nome de exibição dessa pasta é "Versions".The display name of this folder is "Versions".
recoverableitemspurgesrecoverableitemspurges
Exchange 2010Exchange 2010
Em que os itens removidos da pasta exclusões são armazenados.Where items that are removed from the Deletions folder are stored. Todos os itens excluídos do repositório são movidos para esta pasta.All store hard-deleted items are moved to this folder. O nome de exibição para esta pasta é "limpezas".The display name for this folder is "Purges".
archiveddeletedtitemsarchiveddeletedtitems
Exchange 2010Exchange 2010
A pasta itens excluídos padrão para uma caixa de correio de arquivo morto.The default Deleted Items folder for an archive mailbox.
archiverecoverablesitemsrootarchiverecoverablesitemsroot
Exchange 2010Exchange 2010
A pasta de dumpster raiz para uma caixa de correio de arquivo morto.The root dumpster folder for an archive mailbox. Os itens arquivados excluídos de forma reversível são movidos para uma subpasta nessa pasta.Archived items that are soft-deleted are moved to a subfolder in this folder.
archiverecoverableitemsdeletionsarchiverecoverableitemsdeletions
Exchange 2010Exchange 2010
A pasta de dumpster principal para uma caixa de correio de arquivo morto.The main dumpster folder for an archive mailbox. Os itens arquivados movidos para o dumpster são colocados aqui.Archived items moved to the dumpster are placed here.
archiverecoverableitemsversionsarchiverecoverableitemsversions
Exchange 2010Exchange 2010
Onde as versões mais antigas dos itens arquivados são armazenadas.Where older versions of archived items are stored.
archiverecoverableitemspurgesarchiverecoverableitemspurges
Exchange 2010Exchange 2010
Em que os itens que são excluídos da pasta de exclusões de arquivo morto no dumpster estão armazenados.Where items that are hard-deleted from the archive Deletions folder in the dumpster are stored. Todos os itens arquivados excluídos do repositório são movidos para esta pasta.All store hard-deleted archived items are moved to this folder.

Como faço para excluir itens?How do I delete items?

Use uma das opções a seguir para indicar se mover um item para a pasta itens excluídos ou executar uma exclusão reversível ou uma exclusão difícil:Use one of the following to indicate whether to move an item to the Deleted Items folder or perform a soft delete or a hard delete:

  • O tipo simples alientype , se você usar EWS para acessar o Exchange.The DisposalType simple type, if you use EWS to access Exchange.

  • A Enumeração deleteMode, se você usar a API gerenciada do EWS.The DeleteMode enumeration, if you use the EWS Managed API.

Você pode usar um número de operações EWS diferentes ou métodos de API gerenciada do EWS para excluir itens e pastas de uma caixa de correio.You can use a number of different EWS operations or EWS Managed API methods to delete items and folders from a mailbox.

Tabela 3: operações do EWS e métodos da API gerenciada do EWS para exclusão de itensTable 3: EWS operations and EWS Managed API methods for deleting items

Operação do EWSEWS operation Método de API gerenciada do EWSEWS Managed API method Introduzido noIntroduced in FunçãoWhat it does
Operação DeleteFolderDeleteFolder operation
Método Folder. DeleteFolder.Delete method
Exchange 2007Exchange 2007
Exclui pastas de uma caixa de correio.Deletes folders from a mailbox. Com o EWS, você pode excluir pastas em lote.With EWS, you can batch delete folders. Com a API gerenciada do EWS, você só pode excluir uma única pasta por chamada.With the EWS Managed API, you can only delete a single folder per call.
Operação DeleteItemDeleteItem operation
Método item. DeleteItem.Delete method

Método ExchangeService. DeleteItemsExchangeService.DeleteItems method
Exchange 2007Exchange 2007
Exclui itens de uma caixa de correio.Deletes items from a mailbox.
Operação EmptyFolderEmptyFolder operation
Método Folder. EmptyFolder.Empty method
Exchange 2010Exchange 2010
Exclui todos os itens em uma pasta e, opcionalmente, exclui todas as subpastas em uma pasta.Deletes all the items in a folder, and, optionally, deletes all subfolders in a folder.
Operação ApplyConversationActionApplyConversationAction operation
Método CONVERSATION. EnableAlwaysDeleteItemsConversation.EnableAlwaysDeleteItems method

Método CONVERSATION. DeleteItemsConversation.DeleteItems method
Exchange 2010Exchange 2010
Define uma ação de processamento de exclusão em mensagens de email em uma conversa para que elas sejam excluídas.Sets a delete processing action on email messages in a conversation so that they are deleted.
Operação DeleteUserConfigurationDeleteUserConfiguration operation
Método userconfiguration. DeleteUserConfiguration.Delete method
Exchange 2010Exchange 2010
Exclui um item associado à pasta e o move para o dumpster.Deletes a folder associated item and moves it to the dumpster.
Operação CreateItemCreateItem operation
Método de compromisso. AcceptAppointment.Accept method

Método de compromisso. AcceptTentativelyAppointment.AcceptTentatively method

Método de compromisso. CancelMeetingAppointment.CancelMeeting method

Compromisso. recusarAppointment.Decline

Método MeetingRequest. AcceptMeetingRequest.Accept method

Método MeetingRequest. AcceptTentativelyMeetingRequest.AcceptTentatively method

Método MeetingRequest. rejeiçãoMeetingRequest.Decline method
Exchange 2007Exchange 2007
Move indiretamente um item para a pasta itens excluídos sempre que uma resposta a uma solicitação de reunião é enviada ou a resposta é definida no compromisso.Indirectly moves an item to the Deleted Items folder whenever a response to a meeting request is sent or the response is set on the appointment.

O tipo de exclusão não está definido nessa operação.The deletion type is not set on this operation. As mensagens de reunião são movidas para a pasta itens excluídos quando um objeto Response é processado com êxito pelo serviço.The meeting messages are moved to the Deleted Items folder when a response object is successfully processed by the service.

Você também pode mover itens para a pasta itens excluídos usando regras de caixa de entrada.You can also move items to the Deleted Items folder by using Inbox rules. Por exemplo, você pode criar regras que têm uma ação de exclusão.For example, you can create rules that have a delete action.

Alguns pontos a serem observados sobre a exclusão de itens:Some points to note about deleting items:

  • Excluir uma ocorrência de um item recorrente não dispara uma movimentação para a pasta itens excluídos ou o dumpster.Deleting an occurrence of a recurring item does not trigger a move to the Deleted Items folder or the dumpster. Isso resulta em uma atualização para o item mestre recorrente da série recorrente.This results in an update to the recurring master item of the recurring series.

  • Não é possível excluir pastas padrão da caixa de correio.You cannot delete default folders from the mailbox.

  • Evite excluir reuniões ou mensagens de reunião, como solicitações de reunião e atualizações de reunião.Avoid deleting meetings or meeting messages, such as meeting requests and or meeting updates. Em vez disso, responda a esses itens usando objetos Response.Instead, respond to these items by using response objects. Dessa forma, os itens de calendário associados são atualizados para refletir as ações do Respondente ou do organizador.This way, the associated calendar items are updated to reflect the responder's or organizer's actions.

  • A chave de alteração de um item não é atualizada quando o item é movido para a pasta itens excluídos ou exclusões.An item's change key is not updated when the item is moved to the Deleted Items or Deletions folder.

  • Se você executar uma exclusão de hardware em um item e, em seguida, chamar uma operação SyncFolderHierarchy ou um método de API gerenciada do EWS do SyncFolderHierarchy , ou uma operação SyncFolderItems ou SyncFolderItems , uma entrada de alteração de exclusão será retornada.If you perform a hard delete on an item and then call a SyncFolderHierarchy operation or SyncFolderHierarchy EWS Managed API method, or a SyncFolderItems operation or SyncFolderItems method, a Delete change entry will be returned. Se você mover um item para a pasta itens excluídos, uma entrada de alteração de atualização será retornada.If you move an item to the Deleted Items folder, an Update change entry is returned. Isso ocorre porque o item ou a pasta terá um novo valor da propriedade ParentFolderId .This is because the item or folder will have a new ParentFolderId property value. Leia mais sobre sincronização se a sincronização de itens excluídos fizer parte do seu cenário.Read more about synchronization if synchronizing deleted items is part of your scenario.

Saiba mais sobre como excluir itensFind out more about deleting items

Confira tambémSee also