Поделиться через

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

Комментарии

Важно!

  • Свойство contentId поддерживается только в Outlook в Интернете, новом Outlook для Windows и классическом Outlook для Windows (предварительная версия). Чтобы предварительно просмотреть contentId свойство в классической версии Outlook в Windows, клиент Outlook должен запустить версию 2510 (сборка 19312.20000) или более позднюю версию и быть на канале бета-версии. Дополнительные сведения см. в статье Программа предварительной оценки Microsoft 365.

  • Изменения в том, как встроенные изображения представлены в тексте 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