Opération GetAttachmentGetAttachment operation

L’opération GetAttachment est utilisée pour récupérer des pièces jointes existantes sur des éléments de la Banque d’Exchange.The GetAttachment operation is used to retrieve existing attachments on items in the Exchange store.

Exemple de requête GetAttachmentGetAttachment request example

DescriptionDescription

L’exemple de requête GetAttachment suivant montre comment obtenir une pièce jointe.The following example of GetAttachment request shows how to get an attachment.

CodeCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <GetAttachment xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <AttachmentShape/>
      <AttachmentIds>
        <t:AttachmentId Id="AAAtAEFkbWluaX..."/>
      </AttachmentIds>
    </GetAttachment>
  </soap:Body>
</soap:Envelope>

CommentairesComments

L’élément AttachmentShape vous permet de spécifier les informations de pièce jointe à renvoyer.The AttachmentShape element allows you to specify which attachment information should be returned. Un élément AttachmentShape vide est valide et affiche vos pièces jointes sans contenu MIME pour les pièces jointes d’éléments, avec un type de corps de texte et sans propriétés supplémentaires.An empty AttachmentShape element is valid and will render your attachments without MIME content for item attachments, with a text body type, and without any additional properties.

La collection AttachmentIds vous permet de spécifier un ou plusieurs identificateurs de pièce jointe à renvoyer.The AttachmentIds collection allows you to specify one or more attachment identifiers to return. Notez que ces éléments sont de type RequestAttachmentIdType, de sorte que les AttachmentIds que vous recevez de CreateAttachment doivent être supprimés des attributs RootItemId et RootItemChangeKey avant de les transmettre à GetAttachment.Note that these are of type RequestAttachmentIdType, so any AttachmentIds that you receive from CreateAttachment must have the RootItemId and RootItemChangeKey attributes removed before passing them to GetAttachment.

Notes

L’identificateur de pièce jointe et la clé de modification ont été raccourcies afin de préserver la lisibilité.The attachment identifier and change key have been shortened to preserve readability.

Demander des élémentsRequest elements

Les éléments suivants sont utilisés dans la demande :The following elements are used in the request:

Exemple de réponse GetAttachmentGetAttachment response example

DescriptionDescription

L’exemple suivant montre une réponse réussie à une demande GetAttachment.The following example shows a successful response to a GetAttachment request. Cet exemple renvoie une pièce jointe de fichier.This example returns a file attachment.

CodeCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="662" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <GetAttachmentResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                           xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:GetAttachmentResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Attachments>
            <t:FileAttachment>
              <t:AttachmentId Id="AAAtAEFkbWluaX..."/>
              <t:Name>SomeFile</t:Name>
              <t:Content>AQIDBAU=</t:Content>
            </t:FileAttachment>
          </m:Attachments>
        </m:GetAttachmentResponseMessage>
      </m:ResponseMessages>
    </GetAttachmentResponse>
  </soap:Body>
</soap:Envelope>

CommentairesComments

Les messages de réponse pour GetAttachment contiennent toujours la pièce jointe complète ; autrement dit, toutes les propriétés sont toujours incluses.The response messages for GetAttachment will always contain the full attachment; that is, all properties will always be included. Pour les pièces jointes, ces propriétés sont Name (AttachmentType), ContentType, contentid, ContentLocationet content.For file attachments, those properties are Name (AttachmentType), ContentType, ContentId, ContentLocation, and Content. Pour les pièces jointes d’éléments, ces propriétés sont Name (AttachmentType), ContentType, contentid, ContentLocation et toutes les propriétés de l’élément, comme si la forme AllProperties avait été utilisée dans un appel de GetItem.For item attachments, those properties are Name (AttachmentType), ContentType, ContentId, ContentLocation and all of the item's properties, as if the AllProperties shape had been used in a GetItem call. L’élément AttachmentShape , s’il est présent, permet à une application consommateur de demander des propriétés étendues supplémentaires pour les pièces jointes d’éléments.The AttachmentShape element, if present, will allow a consumer application to request additional extended properties for item attachments.

Éléments de réponse réussisSuccessful response elements

Les éléments suivants sont utilisés dans la réponse :The following elements are used in the response:

Voir aussiSee also

Opération CreateAttachmentCreateAttachment operation

Opération DeleteAttachmentDeleteAttachment operation