Операция GetAttachment

  • Статья

Операция GetAttachment используется для получения существующих вложений к элементам в хранилище Exchange.

Пример запроса GetAttachment

Описание

В следующем примере запроса GetAttachment показано, как получить вложение.

Код

<?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>

Comments

Элемент AttachmentShape позволяет указать, какие сведения о вложении должны быть возвращены. Пустой элемент AttachmentShape является допустимым и будет отображать вложения без содержимого MIME для вложений элементов, с типом текста текста и без дополнительных свойств.

Коллекция AttachmentIds позволяет указать один или несколько идентификаторов вложений для возврата. Обратите внимание, что они относятся к типу RequestAttachmentIdType, поэтому перед передачей атрибутов AttachmentId, получаемых из CreateAttachment, должны быть удалены атрибуты RootItemId и RootItemChangeKey.

Примечание.

Идентификатор вложения и ключ изменения сокращены, чтобы сохранить удобочитаемость.

Элементы запроса

В запросе используются следующие элементы:

Пример ответа GetAttachment

Описание

В следующем примере показан успешный ответ на запрос GetAttachment. В этом примере возвращается вложение файла.

Код

<?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>

Comments

Ответные сообщения для GetAttachment всегда будут содержать полное вложение; то есть все свойства всегда будут включены. Для вложений файлов эти свойства: Name (AttachmentType),ContentType, ContentId, ContentLocation и Content. Для вложений элементов это свойства Name (AttachmentType),ContentType, ContentId, ContentLocation и все свойства элемента, как если бы фигура AllProperties использовалась в вызове GetItem. Элемент AttachmentShape , если он присутствует, позволяет приложению-получателю запрашивать дополнительные расширенные свойства для вложений элементов.

Элементы успешного отклика

В ответе используются следующие элементы:

См. также

Операция CreateAttachment

Операция DeleteAttachment