Operação MarkAllItemsAsReadMarkAllItemsAsRead operation

Encontre informações sobre a operação do EWS do MarkAllItemsAsRead .Find information about the MarkAllItemsAsRead EWS operation.

A operação MarkAllItemsAsRead define a propriedade IsRead em todos os itens, em uma ou mais pastas, para indicar que todos os itens são lidos ou não lidos.The MarkAllItemsAsRead operation sets the IsRead property on all items, in one or more folders, to indicate that all items are either read or unread.

This operation was introduced in Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Usando a operação MarkAllItemsAsReadUsing the MarkAllItemsAsRead operation

A operação MarkAllItemsAsRead pode definir a propriedade IsRead em todos os itens em pastas identificadas pelo identificador de pasta dos serviços Web do Exchange (EWS) ou o nome da pasta padrão do Exchange.The MarkAllItemsAsRead operation can set the IsRead property on all items in folders identified by either the Exchange Web Services (EWS) folder identifier or the default Exchange folder name. A operação MarkAllItemsAsRead também pode suprimir o envio de confirmações de leitura para itens marcados como lidos.The MarkAllItemsAsRead operation can also suppress the sending of read receipts for items marked as read.

Cabeçalhos SOAP de operação MarkAllItemsAsReadMarkAllItemsAsRead operation SOAP headers

A operação MarkAllItemsAsRead pode usar os cabeçalhos SOAP listados na tabela a seguir.The MarkAllItemsAsRead operation can use the SOAP headers that are listed in the following table.

Nome de cabeçalhoHeader name ElementoElement DescriçãoDescription
RepresentaçãoImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica o usuário que o aplicativo cliente está representando.Identifies the user whom the client application is impersonating. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica a cultura, conforme definido na RFC 3066, "marcas de identificação de idiomas", a ser usado para acessar a caixa de correio.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica a versão do esquema para a solicitação de operação.Identifies the schema version for the operation request. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação.Identifies the version of the server that responded to the request. Este cabeçalho é aplicável a uma resposta.This header is applicable to a response.

Exemplo de solicitação de operação MarkAllItemsAsRead: marcar todos os itens em uma pasta como lidasMarkAllItemsAsRead operation request example: Mark all items in a folder as read

O exemplo a seguir de uma solicitação de operação MarkAllItemsAsRead mostra como definir a propriedade IsRead , que também é chamada de sinalizador de leitura, como true em todos os itens em uma pasta.The following example of a MarkAllItemsAsRead operation request shows how to set the IsRead property, which is also called the read flag, to true on all items in a folder. Este exemplo também mostra que as confirmações de leitura não são enviadas em resposta a nenhuma solicitação de confirmação de leitura.This example also shows that read receipts are not sent in response to any read receipt requests.

Observação

Todos os identificadores de item e as chaves de alteração deste artigo foram reduzidos para preservar a legibilidade.All item identifiers and change keys in this article have been shortened to preserve readability. As chaves de alteração não são necessárias para esta operação.Change keys are not required for this operation.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
   </soap:Header>
   <soap:Body>
      <m:MarkAllItemsAsRead>
         <m:ReadFlag>true</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

O corpo SOAP de solicitação contém os seguintes elementos:The request SOAP body contains the following elements:

Resposta de operação MarkAllItemsAsRead bem-sucedidaSuccessful MarkAllItemsAsRead operation response

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação MarkAllItemsAsRead para marcar todos os itens de uma pasta como lidos.The following example shows a successful response to a MarkAllItemsAsRead operation request to mark all items in a folder as read.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <m:MarkAllItemsAsReadResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Success">
               <m:ResponseCode>NoError</m:ResponseCode>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

O corpo SOAP de resposta contém os seguintes elementos:The response SOAP body contains the following elements:

Exemplo de solicitação de operação MarkAllItemsAsRead: marcar todos os itens em uma pasta como não lidasMarkAllItemsAsRead operation request example: Mark all items in a folder as unread

O exemplo a seguir de uma solicitação de operação MarkAllItemsAsRead mostra como definir a propriedade IsRead como false em todos os itens em uma pasta.The following example of a MarkAllItemsAsRead operation request shows how to set the IsRead property to false on all items in a folder. Este exemplo também mostra que as confirmações de leitura não são enviadas em resposta a nenhuma solicitação de confirmação de leitura.This example also shows that read receipts are not sent in response to any read receipt requests.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
   </soap:Header>
   <soap:Body>
      <m:MarkAllItemsAsRead>
         <m:ReadFlag>false</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

Uma resposta bem-sucedida a uma solicitação para marcar todos os itens como lido é o mesmo que a resposta a uma solicitação para marcar todos os itens como não lidos.A successful response to a request to mark all items as read is the same as the response to a request to mark all items as unread.

O corpo SOAP de solicitação contém os seguintes elementos:The request SOAP body contains the following elements:

Resposta de erro de operação MarkAllItemsAsReadMarkAllItemsAsRead operation error response

O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação MarkAllItemsAsRead para marcar todos os itens de uma pasta como lidos ou não lidos quando a pasta não existe na caixa de correio.The following example shows an error response to a MarkAllItemsAsRead operation request to mark all items in a folder as read or unread when the folder does not exist in the mailbox.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <m:MarkAllItemsAsReadResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Error">
               <m:MessageText>The specified object was not found in the store.</m:MessageText>
               <m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
               <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

O corpo SOAP de resposta de erro contém os seguintes elementos:The error response SOAP body contains the following elements:

Confira tambémSee also