Office.AttachmentDetails interface

Paquet:
outlook

Représente la pièce jointe d’un élément du serveur. Mode Lecture uniquement.

Un tableau d’objets AttachmentDetails est renvoyé comme propriété d’un attachments élément de rendez-vous ou de message.

Remarques

Jeu d’API : Boîte aux lettres 1.1

Niveau d’autorisation minimal : lire l’élément

Mode Outlook applicable : Lecture

Utilisateur

Exemples

// 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.");
}

Propriétés

attachmentType

Obtient une valeur qui indique le type de la pièce jointe.
contentId

Obtient l’identificateur de contenu d’une pièce jointe incluse.
contentType

Obtient le type de contenu MIME de la pièce jointe.

Avertissement : bien que la contentType valeur soit une recherche directe de l’extension de la pièce jointe, le mappage interne n’est pas activement maintenu et cette propriété a été déconseillée. Si vous avez besoin de types spécifiques, saisissez l’extension de la pièce jointe et traitez-la en conséquence. Pour plus d’informations, reportez-vous au billet de blog associé.
id

Obtient l’ID de pièce jointe Exchange de la pièce jointe. Toutefois, si le type de pièce jointe est MailboxEnums.AttachmentType.Cloud, une URL du fichier est renvoyée.
isInline

Obtient une valeur qui indique si la pièce jointe apparaît sous la forme d’une image dans le corps de l’élément plutôt que dans la liste des pièces jointes.
name

Obtient le nom de la pièce jointe.
size

Obtient la taille de la pièce jointe en octets.

Détails de la propriété

attachmentType

Obtient une valeur qui indique le type de la pièce jointe.

attachmentType: MailboxEnums.AttachmentType | string;

Valeur de propriété

Office.MailboxEnums.AttachmentType | string

contentId

Obtient l’identificateur de contenu d’une pièce jointe incluse.

contentId: string;

Valeur de propriété

string

Remarques

Jeu d’API : Boîte aux lettres 1.16

Important : modifications apportées à la façon dont les images incorporées sont représentées dans le corps HTML des e-mails Outlook dans Outlook sur le web et la nouvelle version d’Outlook sur Windows publiée le 15 novembre 2025. Auparavant, l’ID de pièce jointe de l’image apparaissait dans l’attribut src de l’élément applicable <img> . L’image est à présent représentée par un ID de contenu (cid) dans l’attribut src . Si vous analysez l’ID de pièce jointe à partir de l’éditeur HTML ou si vous obtenez la valeur codée en Base64 de l’image à partir de l’URL dans l’attribut src , vous devez mettre à jour la logique d’analyse de votre complément. Pour plus d’informations, consultez Modifications apportées à la représentation d’images en ligne dans Outlook sur le web et la nouvelle version d’Outlook pour Windows.

contentType

Avertissement

Cette API est à présent déconseillée.

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

Obtient le type de contenu MIME de la pièce jointe.

Avertissement : bien que la contentType valeur soit une recherche directe de l’extension de la pièce jointe, le mappage interne n’est pas activement maintenu et cette propriété a été déconseillée. Si vous avez besoin de types spécifiques, saisissez l’extension de la pièce jointe et traitez-la en conséquence. Pour plus d’informations, reportez-vous au billet de blog associé.

contentType: string;

Valeur de propriété

string

id

Obtient l’ID de pièce jointe Exchange de la pièce jointe. Toutefois, si le type de pièce jointe est MailboxEnums.AttachmentType.Cloud, une URL du fichier est renvoyée.

id: string;

Valeur de propriété

string

isInline

Obtient une valeur qui indique si la pièce jointe apparaît sous la forme d’une image dans le corps de l’élément plutôt que dans la liste des pièces jointes.

isInline: boolean;

Valeur de propriété

boolean

name

Obtient le nom de la pièce jointe.

name: string;

Valeur de propriété

string

Remarques

Important : Un document de type Office.MailboxEnums.AttachmentType.Item ne renvoie pas d’extension de nom de fichier dans la name propriété.

size

Obtient la taille de la pièce jointe en octets.

size: number;

Valeur de propriété

number