Office.AttachmentDetails interface

Paket:
outlook

Stellt eine Anlage zu einem Element vom Server dar. Nur im Lesemodus.

Ein Array von AttachmentDetails Objekten wird als attachments Eigenschaft eines Termins oder eines Nachrichtenelements zurückgegeben.

Hinweise

API-Satz: Postfach 1.1

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Lesen

Verwendet von

Beispiele

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

Eigenschaften

attachmentType

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

Ruft den Inhaltsbezeichner einer Inline-Anlage ab.
contentType

Ruft den MIME-Inhaltstyp der Anlage ab.

Warnung: Der Wert ist zwar contentType ein direkter Lookup der Erweiterung der Anlage, die interne Zuordnung wird jedoch nicht aktiv beibehalten, sodass diese Eigenschaft nicht mehr funktioniert. Wenn Sie bestimmte Typen benötigen, greifen Sie auf die Erweiterung der Anlage zu, und verarbeiten Sie den Vorgang entsprechend. Weitere Informationen finden Sie im entsprechenden Blogbeitrag.
id

Ruft die Exchange-Anlagen-ID der Anlage ab. Wenn der Anlagentyp MailboxEnums.AttachmentType.Cloudjedoch ist, wird eine URL für die Datei zurückgegeben.
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.
name

Ruft den Namen der Anlage ab.
size

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

Details zur Eigenschaft

attachmentType

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

attachmentType: MailboxEnums.AttachmentType | string;

Eigenschaftswert

Office.MailboxEnums.AttachmentType | string

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.

contentType

Warnung

Diese API ist nun veraltet.

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

Ruft den MIME-Inhaltstyp der Anlage ab.

Warnung: Der Wert ist zwar contentType ein direkter Lookup der Erweiterung der Anlage, die interne Zuordnung wird jedoch nicht aktiv beibehalten, sodass diese Eigenschaft nicht mehr funktioniert. Wenn Sie bestimmte Typen benötigen, greifen Sie auf die Erweiterung der Anlage zu, und verarbeiten Sie den Vorgang entsprechend. Weitere Informationen finden Sie im entsprechenden Blogbeitrag.

contentType: string;

Eigenschaftswert

string

id

Ruft die Exchange-Anlagen-ID der Anlage ab. Wenn der Anlagentyp MailboxEnums.AttachmentType.Cloudjedoch ist, wird eine URL für die Datei zurückgegeben.

id: string;

Eigenschaftswert

string

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

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.

size

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

size: number;

Eigenschaftswert

number