Office.AttachmentDetailsCompose interface

Paket:
outlook

Stellt eine Anlage in einem Element dar. Nur im Verfassen-Modus.

Ein Array von AttachmentDetailsCompose Objekten wird von der getAttachmentsAsync Methode zurückgegeben.

Hinweise

API-Satz: Postfach 1.8

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose

Verwendet von

Beispiele

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

Eigenschaften

attachmentType

Ruft einen Wert ab, der den Typ der Anlage angibt.
contentId

Ruft den Inhaltsbezeichner einer Inline-Anlage ab.
id

Ruft den Bezeichner einer Anlage ab. Der Wert variiert je nach Outlook-Client.

  • In Outlook im Web und im neuen Outlook unter Windows ist der Bezeichner die Exchange-Webdienste-ID (EWS). Bei Inlineanlagen ist die anfängliche Kennung eine temporäre Anlagen-ID mit addinIddem Präfix , während die Anlage auf den Server hochgeladen wird. Sobald der Upload abgeschlossen ist, erhält die Anlage eine EWS-ID. Einzelheiten finden Sie in den Hinweisen im Abschnitt "Hinweise".

  • In Outlook unter Windows (klassisch) und unter Mac ist der Index der Anlage der Bezeichner für Inline- und Nicht-Inline-Anlagen.
isInline

Ruft einen Wert ab, der angibt, ob die Anlage als Bild im Textkörper des Elements und nicht in der Liste der Anlagen angezeigt wird.
isServiceAccessible

Gibt in Outlook im Web und dem neuen Outlook unter Windows an, ob eine Inlineanlage in einer Nachricht auf den Server hochgeladen und mit einer Exchange-Webdienste-ID (Exchange-Webdienste, EWS) versehen wurde.
name

Ruft den Namen der Anlage ab.
size

Ruft die Größe der Anlage in Byte ab.
url

Ruft die URL der Anlage ab, wenn ihr Typ ist MailboxEnums.AttachmentType.Cloud.

Details zur Eigenschaft

attachmentType

Ruft einen Wert ab, der den Typ der Anlage angibt.

attachmentType: MailboxEnums.AttachmentType | string;

Eigenschaftswert

Office.MailboxEnums.AttachmentType | string

Hinweise

Wichtig:

  • In Outlook im Web und im neuen Outlook unter Windows ist Office.MailboxEnums.AttachmentType.Fileeine Nachricht oder ein Termin, die lokal gespeichert und dann per Drag-and-Drop angefügt und dann mit der Option "Element anfügen" angefügt wird. Die Dateinamenerweiterung wird in der name Eigenschaft zurückgegeben. Eine Nachricht oder ein Termin, die mit der Option Als Anlage weiterleiten angehängt wurde, ist jedoch vom Typ Office.MailboxEnums.AttachmentType.Item. In diesem Fall wird keine Erweiterung in der name Eigenschaft zurückgegeben.

  • Im klassischen Outlook unter Windows ist Office.MailboxEnums.AttachmentType.Itemeine Nachricht oder ein Termin, die bzw. der mithilfe von Drag-and-Drop, Datei anfügen oder Als Anlage weiterleiten angefügt wurde. Eine Dateinamenerweiterung wird in der name Eigenschaft nicht zurückgegeben.

  • In Outlook für Mac ist Office.MailboxEnums.AttachmentType.Fileeine Nachricht oder ein Termin, der per Drag-and-Drop, Element anfügen oder Als Anlage weiterleiten angefügt wurde. Die Dateinamenerweiterung wird in der name Eigenschaft zurückgegeben.

contentId

Ruft den Inhaltsbezeichner einer Inline-Anlage ab.

contentId: string;

Eigenschaftswert

string

Hinweise

API-Satz: Postfach 1.16

Wichtig: Änderungen an der Darstellung von Inlinebildern im HTML-Text von Outlook-E-Mails in Outlook im Web und dem neuen Outlook unter Windows, das am 15. November 2025 veröffentlicht wurde. Zuvor wurde die Anlagen-ID des Bilds im src Attribut des anwendbaren <img> Elements angezeigt. Jetzt wird das Bild stattdessen durch eine Inhalts-ID (cid) im src Attribut dargestellt. Wenn Sie die Anlagen-ID aus dem HTML-Editor analysieren oder den Base64-codierten Wert des Bilds aus der URL im src Attribut abrufen, müssen Sie die Analyselogik Ihres Add-Ins aktualisieren. Weitere Informationen finden Sie unter Änderungen an der Inlinebilddarstellung in Outlook im Web und dem neuen Outlook für Windows.

id

Ruft den Bezeichner einer Anlage ab. Der Wert variiert je nach Outlook-Client.

  • In Outlook im Web und im neuen Outlook unter Windows ist der Bezeichner die Exchange-Webdienste-ID (EWS). Bei Inlineanlagen ist die anfängliche Kennung eine temporäre Anlagen-ID mit addinIddem Präfix , während die Anlage auf den Server hochgeladen wird. Sobald der Upload abgeschlossen ist, erhält die Anlage eine EWS-ID. Einzelheiten finden Sie in den Hinweisen im Abschnitt "Hinweise".

  • In Outlook unter Windows (klassisch) und unter Mac ist der Index der Anlage der Bezeichner für Inline- und Nicht-Inline-Anlagen.

id: string;

Eigenschaftswert

string

Hinweise

Wichtig: Ab dem 30. März 2026 wird Inlinebildern in Nachrichten in Outlook im Web und dem neuen Outlook unter Windows nach Abschluss des Aufrufs an addFileAttachmentAsync oder addFileAttachmentFromBase64Async mit isInlinetrue "Als festgelegt an" lokal eine temporäre Anlagen-ID zugewiesen, während sie auf den Server hochgeladen werden. Einer temporären Anlagen-ID wird das Präfix vorangestellt.addinId Nachdem die Bilder auf den Server hochgeladen wurden, wird ihnen eine Exchange-Webdienste-ID (EWS) zugewiesen. Die temporäre Anlagen-ID wird nur für die Dauer der aktuellen Verfassen-Sitzung unterstützt. Weitere Informationen zu den Änderungen an der Handhabung von Inlinebildern finden Sie unter Änderungen an Anlagen-IDs für Inlinebilder in Outlook-Add-Ins.

isInline

Ruft einen Wert ab, der angibt, ob die Anlage als Bild im Textkörper des Elements und nicht in der Liste der Anlagen angezeigt wird.

isInline: boolean;

Eigenschaftswert

boolean

isServiceAccessible

Gibt in Outlook im Web und dem neuen Outlook unter Windows an, ob eine Inlineanlage in einer Nachricht auf den Server hochgeladen und mit einer Exchange-Webdienste-ID (Exchange-Webdienste, EWS) versehen wurde.

isServiceAccessible: boolean;

Eigenschaftswert

boolean

Hinweise

Wichtig:

  • Ab dem 30. März 2026 wird Inlinebildern in Outlook im Web und dem neuen Outlook unter Windows nach Abschluss des Aufrufs zu addFileAttachmentAsync oder addFileAttachmentFromBase64Async mit isInlinetrue "Als festgelegt an" lokal eine temporäre Anlagen-ID zugewiesen, während sie auf den Server hochgeladen werden. Einer temporären Anlagen-ID wird das Präfix vorangestellt.addinId Nachdem die Bilder auf den Server hochgeladen wurden, wird ihnen in der id Eigenschaft eine Exchange-Webdienste (EWS)-ID zugewiesen und ihre isServiceAccessible Eigenschaft auf truefestgelegt. Die temporäre Anlagen-ID wird nur für die Dauer der aktuellen Verfassen-Sitzung unterstützt. Weitere Informationen zu den Änderungen an der Handhabung von Inlinebildern finden Sie unter Änderungen an Anlagen-IDs für Inlinebilder in Outlook-Add-Ins.

  • In Outlook unter Windows (klassisch) und auf Mac wird die isServiceAccessible Eigenschaft immer zurückgegeben false , da die Anlagen-ID der Index der Anlage ist.

name

Ruft den Namen der Anlage ab.

name: string;

Eigenschaftswert

string

Hinweise

Wichtig:

  • Eine Anlage dieses Typs Office.MailboxEnums.AttachmentType.Item gibt keine Dateinamenerweiterung in der name Eigenschaft zurück.

  • In Outlook im Web und im neuen Outlook unter Windows ist Office.MailboxEnums.AttachmentType.Fileeine Nachricht oder ein Termin, die lokal gespeichert und dann per Drag-and-Drop angefügt und dann mit der Option "Element anfügen" angefügt wird. Die Dateinamenerweiterung wird in der name Eigenschaft zurückgegeben. Eine Nachricht oder ein Termin, die mit der Option Als Anlage weiterleiten angehängt wurde, ist jedoch vom Typ Office.MailboxEnums.AttachmentType.Item. In diesem Fall wird keine Erweiterung in der name Eigenschaft zurückgegeben.

  • Im klassischen Outlook unter Windows ist Office.MailboxEnums.AttachmentType.Itemeine Nachricht oder ein Termin, die bzw. der mithilfe von Drag-and-Drop, Datei anfügen oder Als Anlage weiterleiten angefügt wurde. Eine Dateinamenerweiterung wird in der name Eigenschaft nicht zurückgegeben.

  • In Outlook für Mac ist Office.MailboxEnums.AttachmentType.Fileeine Nachricht oder ein Termin, der per Drag-and-Drop, Element anfügen oder Als Anlage weiterleiten angefügt wurde. Die Dateinamenerweiterung wird in der name Eigenschaft zurückgegeben.

size

Ruft die Größe der Anlage in Byte ab.

size: number;

Eigenschaftswert

number

url

Ruft die URL der Anlage ab, wenn ihr Typ ist MailboxEnums.AttachmentType.Cloud.

url?: string;

Eigenschaftswert

string