Partager via

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 retourné en tant que attachments propriété d’un rendez-vous ou d’un élément de message.

Remarques

[ Ensemble d’API : Boîte aux lettres 1.1 ]

Niveau d’autorisation minimal : élément de lecture

Mode Outlook applicable : Lecture

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 géré activement, de sorte que cette propriété a été dépréciée. Si vous avez besoin de types spécifiques, récupérez l’extension de la pièce jointe et procédez 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 pour le fichier est retournée.
isInline

Obtient une valeur qui indique si la pièce jointe apparaît sous forme d’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

Important:

  • La contentId propriété est uniquement prise en charge dans Outlook sur le web, la nouvelle version d’Outlook sur Windows et la version classique d’Outlook sur Windows (préversion). Pour afficher un aperçu de la contentId propriété dans Outlook classique sur Windows, votre client Outlook doit exécuter la version 2510 (build 19312.20000) ou une version ultérieure et doit être sur le canal bêta. Pour plus d’informations, consultez Programme Microsoft 365 Insider.

  • Modifications apportées à la façon dont les images inline sont représentées dans le corps HTML des e-mails Outlook dans Outlook sur le web et dans 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> . Désormais, l’image est représentée par un ID de contenu (cid) dans l’attribut à la src place. 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, voir Modifications apportées à la représentation d’image inline dans Outlook sur le web et Nouvel 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 géré activement, de sorte que cette propriété a été dépréciée. Si vous avez besoin de types spécifiques, récupérez l’extension de la pièce jointe et procédez 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 pour le fichier est retournée.

id: string;

Valeur de propriété

string

isInline

Obtient une valeur qui indique si la pièce jointe apparaît sous forme d’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 : une pièce jointe 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