Partager via

Office.AttachmentDetailsCompose interface

Paquet:
outlook

Représente une pièce jointe sur un élément. Mode composition uniquement.

Un tableau d’objets AttachmentDetailsCompose est retourné par la getAttachmentsAsync méthode .

Remarques

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

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

Mode Outlook applicable : Compose

Exemples

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

Office.context.mailbox.item.getAttachmentsAsync((result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.error(result.error.message);
    return;
  }

  if (result.value.length > 0) {
    for (let i = 0; i < result.value.length; i++) {
      const attachment = result.value[i];
      let attachmentType;
      switch (attachment.attachmentType) {
        case Office.MailboxEnums.AttachmentType.Cloud:
          attachmentType = "Attachment is stored in a cloud location";
          break;
        case Office.MailboxEnums.AttachmentType.File:
          attachmentType = "Attachment is a file";
          break;
        case Office.MailboxEnums.AttachmentType.Item:
          attachmentType = "Attachment is an Exchange item";
          break;
      }
      console.log(
        "ID: " +
          attachment.id +
          "\n" +
          "Type: " +
          attachmentType +
          "\n" +
          "Name: " +
          attachment.name +
          "\n" +
          "Size: " +
          attachment.size +
          "\n" +
          "isInline: " +
          attachment.isInline
      );
    }
  } else {
    console.log("No attachments on this message.");
  }
});

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.
id

Obtient l’index de la pièce jointe.
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.
url

Obtient l’URL de la pièce jointe si son type est MailboxEnums.AttachmentType.Cloud.

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

Remarques

Important:

  • Dans Outlook sur le web et outlook sur Windows, un message ou un rendez-vous enregistré localement, puis attaché à l’aide d’un glisser-déplacer ou de l’option Joindre un élément est de type Office.MailboxEnums.AttachmentType.File. L’extension de nom de fichier est retournée dans la name propriété . Toutefois, un message ou un rendez-vous joint à l’aide de l’option Transférer en tant que pièce jointe est de type Office.MailboxEnums.AttachmentType.Item. Dans ce cas, aucune extension n’est retournée dans la name propriété .

  • Dans Outlook classique sur Windows, un message ou un rendez-vous joint à l’aide de glisser-déplacer, Joindre un fichier ou Transférer en tant que pièce jointe est de type Office.MailboxEnums.AttachmentType.Item. Aucune extension de nom de fichier n’est retournée dans la name propriété .

  • Dans Outlook sur Mac, un message ou un rendez-vous joint par glisser-déplacer, Attacher un élément ou Transférer en tant que pièce jointe est de type Office.MailboxEnums.AttachmentType.File. L’extension de nom de fichier est retournée dans la name propriété .

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.

id

Obtient l’index de la pièce jointe.

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é .

  • Dans Outlook sur le web et outlook sur Windows, un message ou un rendez-vous enregistré localement, puis attaché à l’aide d’un glisser-déplacer ou de l’option Joindre un élément est de type Office.MailboxEnums.AttachmentType.File. L’extension de nom de fichier est retournée dans la name propriété . Toutefois, un message ou un rendez-vous joint à l’aide de l’option Transférer en tant que pièce jointe est de type Office.MailboxEnums.AttachmentType.Item. Dans ce cas, aucune extension n’est retournée dans la name propriété .

  • Dans Outlook classique sur Windows, un message ou un rendez-vous joint à l’aide de glisser-déplacer, Joindre un fichier ou Transférer en tant que pièce jointe est de type Office.MailboxEnums.AttachmentType.Item. Aucune extension de nom de fichier n’est retournée dans la name propriété .

  • Dans Outlook sur Mac, un message ou un rendez-vous joint par glisser-déplacer, Attacher un élément ou Transférer en tant que pièce jointe est de type Office.MailboxEnums.AttachmentType.File. L’extension de nom de fichier est retournée dans la name propriété .

size

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

size: number;

Valeur de propriété

number

url

Obtient l’URL de la pièce jointe si son type est MailboxEnums.AttachmentType.Cloud.

url?: string;

Valeur de propriété

string