Compartilhar via

Office.AttachmentDetails interface

Pacote:
outlook

Representa um anexo em um item do servidor. Somente modo de leitura.

Uma matriz de AttachmentDetails objetos é devolvida como propriedade attachments de um compromisso ou item de mensagem.

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/get-attachments-read.yaml

const item = Office.context.mailbox.item;

if (item.attachments.length > 0) {
    for (let i = 0; i < item.attachments.length; i++) {
        const attachment = item.attachments[i];
        console.log(`${i+1}. Name: ${attachment.name}`);
        console.log(`ID: ${attachment.id}`);
        console.log(`Type: ${attachment.attachmentType}`);
        console.log(`Inline content: ${attachment.isInline}`);
        console.log(`Size: ${attachment.size}`);
    }
} else {
    console.log("This mail item doesn't contain any attachments.");
}

Propriedades

attachmentType

Obtém um valor que indica o tipo do anexo.
contentId

Obtém o identificador de conteúdo de um anexo inline.
contentType

Obtém o tipo de conteúdo MIME do anexo.

Aviso: embora o contentType valor seja uma pesquisa direta da extensão do anexo, o mapeamento interno não é mantido ativamente, pelo que esta propriedade foi preterida. Se precisar de tipos específicos, agarre na extensão do anexo e processe-o em conformidade. Para obter detalhes, consulte a mensagem de blogue relacionada.
id

Obtém a ID do Exchange do anexo. No entanto, se o tipo de anexo for MailboxEnums.AttachmentType.Cloud, é devolvido um URL para o ficheiro.
isInline

Obtém um valor que indica se o anexo aparece como uma imagem no corpo do item em vez de na lista de anexos.
name

Obtém o nome de arquivo do anexo.
size

Obtém o tamanho do anexo em bytes.

Detalhes da propriedade

attachmentType

Obtém um valor que indica o tipo do anexo.

attachmentType: MailboxEnums.AttachmentType | string;

Valor da propriedade

Office.MailboxEnums.AttachmentType | string

contentId

Obtém o identificador de conteúdo de um anexo inline.

contentId: string;

Valor da propriedade

string

Comentários

Importante:

  • A contentId propriedade só é suportada no Outlook na Web, no novo Outlook no Windows e no Outlook clássico no Windows (pré-visualização). Para pré-visualizar a contentId propriedade no Outlook clássico no Windows, o seu cliente do Outlook tem de executar a Versão 2510 (Compilação 19312.20000) ou posterior e tem de estar no Canal Beta. Para obter mais informações, consulte Programa Microsoft 365 Insider.

  • Alterações à forma como as imagens inline são representadas no corpo HTML dos e-mails do Outlook no Outlook na Web e no novo Outlook no Windows lançado a 15 de novembro de 2025. Anteriormente, o ID de anexo da imagem aparecia no src atributo do elemento aplicável <img> . Agora, a imagem é representada por um ID de conteúdo (cid) no src atributo . Se analisar o ID de anexo do editor de HTML ou obter o valor codificado em Base64 da imagem a partir do URL no src atributo, tem de atualizar a lógica de análise do suplemento. Para obter mais informações, consulte Alterações à representação de imagens inline no Outlook na Web e no novo Outlook para Windows.

contentType

Aviso

Essa API foi preterida.

If you require specific content types, grab the attachment's extension and process accordingly.

Obtém o tipo de conteúdo MIME do anexo.

Aviso: embora o contentType valor seja uma pesquisa direta da extensão do anexo, o mapeamento interno não é mantido ativamente, pelo que esta propriedade foi preterida. Se precisar de tipos específicos, agarre na extensão do anexo e processe-o em conformidade. Para obter detalhes, consulte a mensagem de blogue relacionada.

contentType: string;

Valor da propriedade

string

id

Obtém a ID do Exchange do anexo. No entanto, se o tipo de anexo for MailboxEnums.AttachmentType.Cloud, é devolvido um URL para o ficheiro.

id: string;

Valor da propriedade

string

isInline

Obtém um valor que indica se o anexo aparece como uma imagem no corpo do item em vez de na lista de anexos.

isInline: boolean;

Valor da propriedade

boolean

name

Obtém o nome de arquivo do anexo.

name: string;

Valor da propriedade

string

Comentários

Importante: um anexo do tipo Office.MailboxEnums.AttachmentType.Item não devolve uma extensão de nome de ficheiro na name propriedade .

size

Obtém o tamanho do anexo em bytes.

size: number;

Valor da propriedade

number