Anexos e EWS no Exchange

  • Artigo

Saiba mais sobre anexos e como a API Gerenciada do EWS ou o EWS no cliente exchange os representa.

Normalmente, anexos são associados a itens de email, mas, na verdade, todos os itens EWS – mensagens de email, itens de calendário, contatos, tarefas – podem incluir anexos.

Tipos de anexos

O EWS categoriza anexos em dois grupos: anexos de arquivo e anexos de item.

  • Anexos de item:Itens EWS fortemente tipados, como mensagens de email e itens de calendário, que são anexados a outro item EWS fortemente tipado. Qualquer item fortemente tipado que possa ser criado usando a API Gerenciada do EWS ou o EWS pode ser usado como um anexo de item. O conteúdo de um anexo de item é o item fortemente tipado, que fornece fácil acesso a todas as suas propriedades. Os anexos de item podem ter seus próprios anexos de item, portanto, uma hierarquia de anexos de item (ou aninhamento de anexos) é possível.

  • Anexos de arquivo: Qualquer arquivo, como um .txt, .jpg, .zip, .pdf ou até mesmo um arquivo .msg. Um anexo de arquivo tem apenas algumas propriedades, uma das quais é o conteúdo codificado base-64 do arquivo.

  • Anexos de referência: Qualquer anexo referenciado por um provedor de arquivos, como um arquivo localizado na nuvem. Um anexo pode ser de vários provedores.

Ao adicionar ou recuperar anexos de um item, você o fará de forma diferente, dependendo se for um anexo de arquivo ou um anexo de item. Por exemplo, para adicionar um anexo de arquivo a um item, basta passar o local do arquivo. Para adicionar um item existente como um anexo de item, você realmente precisa copiar as propriedades ou o conteúdo MIME do item existente para um novo anexo de item; você não pode simplesmente associar-se ao item existente. Portanto, a distinção entre os dois tipos de anexos é importante. Mais detalhes sobre as diferenças entre anexos de item e anexos de arquivo são discutidos nos artigos nesta seção.

Como os anexos são representados programaticamente?

Os anexos são armazenados em uma coleção no item EWS. A coleção de anexos é composta por anexos de arquivo e/ou anexos de item. Os metadados sobre a coleção de anexos estão disponíveis quando você obtém um item usando o método EWS Managed API Item.Bind ou a operação GetItem do EWS, mas chamadas adicionais são necessárias para realmente recuperar o conteúdo dos anexos.

Tabela 1. Metadados de item sobre anexos

Entidade de metadados Propriedade API Gerenciada do EWS Elemento EWS
Indicador de anexo (não sinaliza anexos embutidos)
 Item.HasAttachments
Hasattachments
Coleção Attachment
 Item.Anexos
Anexos
ID do anexo
 Attachment.Id
AttachmentId

Tabela 2. Entidades de anexo

Tipo de anexo Classe de API Gerenciada do EWS Elemento EWS
Anexo de arquivo
 FileAttachment
FileAttachment
Anexo de item
 ItemAttachment
ItemAttachment<TItem>
ItemAttachment
Anexo de referência
 EWS (ReferenceAttachmentType complexType)
ReferenceAttachment

Anexos embutidos

Anexos embutidos são uma raça especial de anexo. Anexos de arquivo e anexos de item podem ser anexos embutidos. Um anexo embutido aparece como parte do conteúdo do corpo e mantém sua posição relativa ao restante do conteúdo no item.

Um anexo será um anexo embutido se a propriedade IsInline da API Gerenciada do EWS ou o elemento IsInline do EWS estiver definido como true. Os anexos embutidos usam as seguintes propriedades e elementos opcionais para identificar o local de um anexo embutido:

Observe que a propriedade HasAttachments da API Gerenciada do EWS e o elemento HasAttachments do EWS não refletem a existência de anexos embutidos e é por isso que anexos embutidos também são chamados de anexos ocultos. Portanto, se você definir a propriedade IsInline da API Gerenciada do EWS ou o elemento IsInline do EWS como true e o item não tiver outros anexos, HasAttachments será definido como false. Se o cliente usar HasAttachments para preencher um indicador de anexo ou ícone em um email, esteja ciente de que o ícone não aparecerá para emails com anexos embutidos.

Nesta seção

Confira também