Office.AttachmentDetails interface

Пакет:
outlook

Представляет вложение элемента с сервера. Только в режиме чтения.

Массив AttachmentDetails объектов возвращается как attachments свойство встречи или элемента сообщения.

Комментарии

Набор API: Почтовый ящик 1.1

Минимальный уровень разрешений: чтение элемента

Применимый режим Outlook: чтение

Используется

Примеры

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

Свойства

attachmentType

Получает значение, указывающее тип вложения.
contentId

Получает идентификатор содержимого встроенного вложения.
contentType

Получает тип контента MIME этого вложения.

Предупреждение. ХотяcontentType значение является прямым поиском расширения вложения, внутреннее сопоставление не поддерживается активно, поэтому это свойство устарело. Если вам нужны определенные типы, возьмите расширение вложения и обработайте его соответствующим образом. Подробности см. в соответствующей записи блога.
id

Получает идентификатор вложения Exchange. Однако если тип вложения — MailboxEnums.AttachmentType.Cloud, возвращается URL-адрес файла.
isInline

Получает значение, указывающее, отображается ли вложение как изображение в тексте элемента, а не в списке вложений.
name

Получает имя вложения.
size

Получает размер вложения в байтах.

Сведения о свойстве

attachmentType

Получает значение, указывающее тип вложения.

attachmentType: MailboxEnums.AttachmentType | string;

Значение свойства

Office.MailboxEnums.AttachmentType | string

contentId

Получает идентификатор содержимого встроенного вложения.

contentId: string;

Значение свойства

string

Комментарии

Набор API: почтовый ящик 1.16

Важно! Изменения в том, как встроенные изображения представлены в HTML-тексте электронных писем Outlook в Outlook в Интернете и новом Outlook для Windows, выпущенном 15 ноября 2025 г. Ранее идентификатор вложения изображения отображался в src атрибуте соответствующего <img> элемента. Теперь изображение представлено идентификатором содержимого (cid) в атрибуте src . Если вы анализируете идентификатор вложения из HTML-редактора или получаете значение изображения в кодировке Base64 из URL-адреса в атрибуте src , необходимо обновить логику синтаксического анализа надстройки. Дополнительные сведения см. в статьях "Изменения встроенного представления изображений в Outlook в Интернете" и "Новый Outlook для Windows".

contentType

Предупреждение

Теперь этот API является нерекомендуемым.

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

Получает тип контента MIME этого вложения.

Предупреждение. ХотяcontentType значение является прямым поиском расширения вложения, внутреннее сопоставление не поддерживается активно, поэтому это свойство устарело. Если вам нужны определенные типы, возьмите расширение вложения и обработайте его соответствующим образом. Подробности см. в соответствующей записи блога.

contentType: string;

Значение свойства

string

id

Получает идентификатор вложения Exchange. Однако если тип вложения — MailboxEnums.AttachmentType.Cloud, возвращается URL-адрес файла.

id: string;

Значение свойства

string

isInline

Получает значение, указывающее, отображается ли вложение как изображение в тексте элемента, а не в списке вложений.

isInline: boolean;

Значение свойства

boolean

name

Получает имя вложения.

name: string;

Значение свойства

string

Комментарии

Важно. Вложение типа Office.MailboxEnums.AttachmentType.Item не возвращает расширение имени файла в свойстве name .

size

Получает размер вложения в байтах.

size: number;

Значение свойства

number