次の方法で共有

Office.AttachmentDetailsCompose interface

パッケージ:
outlook

アイテムの添付ファイルを表します。 新規作成モードのみです。

getAttachmentsAsync メソッドによって、AttachmentDetailsCompose オブジェクトの配列が返されます。

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: 読み取り項目

適用される Outlook モード: Compose

例

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

プロパティ

attachmentType

添付ファイルの型を示す値を取得します。
contentId

インライン添付ファイルのコンテンツ識別子を取得します。
id

添付ファイルのインデックスを取得します。
isInline

添付ファイルの一覧ではなく、アイテムの本文に添付ファイルが画像として表示されるかどうかを示す値を取得します。
name

添付ファイルの名前を取得します。
size

添付ファイルのサイズをバイト単位で取得します。
url

添付ファイルの種類が MailboxEnums.AttachmentType.Cloudの場合は、添付ファイルの URL を取得します。

プロパティの詳細

attachmentType

添付ファイルの型を示す値を取得します。

attachmentType: MailboxEnums.AttachmentType | string;

プロパティ値

Office.MailboxEnums.AttachmentType | string

注釈

重要:

  • Outlook on the webおよび新しい Outlook on Windows では、ローカルに保存された後、ドラッグ アンド ドロップまたは [アイテムの添付] オプションを使用して添付されるメッセージまたは予定は、Office.MailboxEnums.AttachmentType.Fileの種類です。 ファイル名拡張子は、 name プロパティで返されます。 ただし、[ 添付ファイルとして転送 ] オプションを使用して添付されたメッセージまたは予定は、 Office.MailboxEnums.AttachmentType.Item型です。 この場合、 name プロパティでは拡張機能は返されません。

  • 従来の Outlook on Windows では、ドラッグ アンド ドロップ、 ファイルの添付、または 添付ファイルとして転送 を使用して添付されるメッセージまたは予定は、 Office.MailboxEnums.AttachmentType.Itemの種類です。 ファイル名拡張子は、 name プロパティでは返されません。

  • Outlook on Mac では、ドラッグ アンド ドロップ、 アイテムの添付、または 添付ファイルとしての転送 を使用して添付されるメッセージまたは予定は、 Office.MailboxEnums.AttachmentType.Fileの種類です。 ファイル名拡張子は、 name プロパティで返されます。

contentId

インライン添付ファイルのコンテンツ識別子を取得します。

contentId: string;

プロパティ値

string

注釈

重要:

  • contentId プロパティは、Outlook on the web および Outlook on Windows (新規およびクラシック (プレビュー)) でのみサポートされます。 従来の Outlook on Windows で contentId プロパティをプレビューするには、Outlook クライアントでバージョン 2510 (ビルド 19312.20000) 以降を実行する必要があり、ベータ チャネル上にある必要があります。 詳細については、「 Microsoft 365 Insider Program」を参照してください。

  • 2025 年 11 月 15 日から、Outlook on the webの Outlook メールの HTML 本文でインライン イメージを表す方法が変更され、新しい Outlook on Windows が運用ユーザーへのロールアウトを開始します。 以前は、イメージの添付 ID が、該当する <img> 要素の src 属性に表示されました。 変更後、イメージは代わりに src 属性のコンテンツ ID (cid) で表されます。 その結果、HTML エディターから添付ファイル ID を解析するか、 src 属性の URL からイメージの Base64 値を取得する場合は、アドインの解析ロジックを更新する必要があります。 詳細については、「Outlook on the webおよび新しい Outlook for Windowsでのインライン イメージ表現の変更」を参照してください。

id

添付ファイルのインデックスを取得します。

id: string;

プロパティ値

string

isInline

添付ファイルの一覧ではなく、アイテムの本文に添付ファイルが画像として表示されるかどうかを示す値を取得します。

isInline: boolean;

プロパティ値

boolean

name

添付ファイルの名前を取得します。

name: string;

プロパティ値

string

注釈

重要:

  • Office.MailboxEnums.AttachmentType.Item型の添付ファイルは、name プロパティのファイル名拡張子を返しません。

  • Outlook on the webおよび新しい Outlook on Windows では、ローカルに保存された後、ドラッグ アンド ドロップまたは [アイテムの添付] オプションを使用して添付されるメッセージまたは予定は、Office.MailboxEnums.AttachmentType.Fileの種類です。 ファイル名拡張子は、 name プロパティで返されます。 ただし、[ 添付ファイルとして転送 ] オプションを使用して添付されたメッセージまたは予定は、 Office.MailboxEnums.AttachmentType.Item型です。 この場合、 name プロパティでは拡張機能は返されません。

  • 従来の Outlook on Windows では、ドラッグ アンド ドロップ、 ファイルの添付、または 添付ファイルとして転送 を使用して添付されるメッセージまたは予定は、 Office.MailboxEnums.AttachmentType.Itemの種類です。 ファイル名拡張子は、 name プロパティでは返されません。

  • Outlook on Mac では、ドラッグ アンド ドロップ、 アイテムの添付、または 添付ファイルとしての転送 を使用して添付されるメッセージまたは予定は、 Office.MailboxEnums.AttachmentType.Fileの種類です。 ファイル名拡張子は、 name プロパティで返されます。

size

添付ファイルのサイズをバイト単位で取得します。

size: number;

プロパティ値

number

url

添付ファイルの種類が MailboxEnums.AttachmentType.Cloudの場合は、添付ファイルの URL を取得します。

url?: string;

プロパティ値

string