Office.LoadedMessageRead interface
表示当前加载的处于读取模式的消息。 当 LoadedMessageRead 在读取模式下对消息调用 时 Office.context.mailbox.loadItemByIdAsync ，将返回 对象。
注解
最低权限级别： 读/写项
适用的 Outlook 模式：邮件读取
重要说明：
实现 项多选功能时，确定是否可以通过调用访问所选项的
Office.context.mailbox.getSelectedItemsAsync必需属性。 如果可以，则无需调用loadItemByIdAsync。一次只能加载一个邮件项目。 实现
loadItemByIdAsync时，必须在处理项后调用unloadAsync。 必须在对另一项调用loadItemByIdAsync之前完成此作。
示例
// Gets the sender's email address of each selected message.
async function getSenderEmailAddress(item) {
const itemId = item.itemId;
await new Promise((resolve) => {
Office.context.mailbox.loadItemByIdAsync(itemId, (result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.log(result.error.message);
return;
}
const loadedItem = result.value;
const sender = loadedItem.from.emailAddress;
console.log(sender);
// Unload the current message before processing another selected message.
loadedItem.unloadAsync((asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log(asyncResult.error.message);
return;
}
resolve();
});
});
});
}
属性
| attachments | 获取项的附件作为数组。 |
| body | 获取项的正文及其格式。 |
| categories | 获取一个 对象，该对象提供管理项类别的方法。 |
| cc | 获取邮件的 抄送 (抄送副本) 的收件人。 属性
|
| conversation |
获取包含特定消息的电子邮件会话的标识符。 如果在阅读窗体或撰写窗体的回复中激活邮件应用程序，则此属性可以获得一个整数值。 如果用户随后更改了回复邮件的主题（若发送回复），则该邮件的对话 ID 将改变且之前获取的值将不适用。 |
| date |
获取项目创建的日期和时间。 |
| date |
获取项目最近一次修改的日期和时间。 |
| end | 获取约会结束的日期和时间。 属性 使用 |
| from | 获取邮件发件人的电子邮件地址。 属性 |
| internet |
获取消息的 Internet 消息标识符。 |
| item |
获取所选邮件的 Exchange Web Services 项类。 |
| item |
|
| item |
获取实例表示的项的类型。 属性 |
| location | 获取会议请求的位置。
|
| normalized |
获取项目的主题，删除所有前缀 (包括 RE： 和 FWD：) 。 属性 |
| notification |
获取项的通知消息。 |
| recurrence | 获取约会的重复模式。 获取会议请求的重复模式。 约会项目的读取和撰写模式。 会议请求项的读取模式。 如果项目是系列 |
| sender | 获取电子邮件发件人的电子邮件地址。 |
| series |
获取实例所属的序列的 ID。 在 Outlook 网页版 和 Windows (new 和 classic) 中， |
| start | 获取约会开始的日期和时间。 属性 |
| subject | 获取在项的主题字段中显示的说明。 属性
|
| to | 获取邮件的“ 收件人 ”行上的收件人。 提供对邮件的“收件人”行上的收件人的访问权限。 对象的类型和访问级别取决于当前项的模式。 属性
|
方法
| display |
显示一个答复表单，其中包括所选邮件的发件人和所有收件人或组织者以及所选约会的所有与会者。 |
| display |
显示一个答复表单，其中包括所选邮件的发件人和所有收件人或组织者以及所选约会的所有与会者。 |
| display |
显示答复窗体，其中仅包括所选邮件的发件人或所选约会的组织者。 |
| display |
显示答复窗体，其中仅包括所选邮件的发件人或所选约会的组织者。 |
| get |
以字符串的形式获取消息的所有 Internet 标头。 若要了解详细信息，请参阅在 Outlook 外接程序中获取和设置邮件的 Internet 标头。 |
| get |
以字符串的形式获取消息的所有 Internet 标头。 若要了解详细信息，请参阅在 Outlook 外接程序中获取和设置邮件的 Internet 标头。 |
| get |
获取以 Base64 编码的 EML 格式的当前消息。 |
| get |
获取以 Base64 编码的 EML 格式的当前消息。 |
| get |
从邮件或约会中获取附件，并将其作为 |
| get |
从邮件或约会中获取附件，并将其作为 |
| get |
获取当 加载项被可作消息激活时传递的初始化数据。 |
| get |
获取当 加载项被可作消息激活时传递的初始化数据。 |
| get |
返回所选项中与 XML 清单文件中定义的正则表达式匹配的字符串值。 |
| get |
返回所选项中与 XML 清单文件中定义的命名正则表达式匹配的字符串值。 |
| get |
返回与 XML 清单文件中定义的正则表达式匹配的突出显示匹配项中的字符串值。 突出显示的匹配项适用于上下文外接程序。 |
| get |
获取共享文件夹或共享邮箱中约会或邮件的属性。 有关使用此 API 的详细信息，请参阅 在 Outlook 外接程序中启用共享文件夹和共享邮箱方案。 |
| get |
获取共享文件夹或共享邮箱中约会或邮件的属性。 有关使用此 API 的详细信息，请参阅 在 Outlook 外接程序中启用共享文件夹和共享邮箱方案。 |
| load |
异步加载所选项目上此外接程序的自定义属性。 自定义属性以键值对的形式存储在每个应用、每个项目的基础上。 此方法在回调中返回 CustomProperties 对象，该对象提供访问特定于当前项和当前加载项的自定义属性的方法。 自定义属性不会对项进行加密，因此不应将其用作安全存储。 自定义属性作为 |
| unload |
选择多个邮件项目后，关闭当前加载的项目，以便可以加载另一个选定的邮件项目进行处理。 |
| unload |
选择多个邮件项目后，关闭当前加载的项目，以便可以加载另一个选定的邮件项目进行处理。 |
属性详细信息
attachments
获取项的附件作为数组。
attachments: AttachmentDetails[];属性值
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
由于潜在的安全问题，某些类型的文件会受到 Outlook 阻止，并且不会返回。 有关详细信息，请参阅 Outlook 中阻止的附件。
不会返回使用 “上传和共享 ”选项添加的附件。
body
获取项的正文及其格式。
body: Body;属性值
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：仅 getAsync 支持 Body 对象的 和 getTypeAsync 方法。
categories
cc
获取邮件的 抄送 (抄送副本) 的收件人。
属性cc返回一个数组，该数组包含邮件抄送行中列出的每个收件人的 EmailAddressDetails 对象。 返回的最大收件人数因 Outlook 客户端而异。
经典 Windows：500 个收件人
Web 浏览器，新 Outlook：20 个收件人 (折叠视图) ,500 个收件人 (展开视图)
cc: EmailAddressDetails[];属性值
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
conversationId
获取包含特定消息的电子邮件会话的标识符。
如果在阅读窗体或撰写窗体的回复中激活邮件应用程序，则此属性可以获得一个整数值。 如果用户随后更改了回复邮件的主题（若发送回复），则该邮件的对话 ID 将改变且之前获取的值将不适用。
conversationId: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
dateTimeCreated
dateTimeModified
获取项目最近一次修改的日期和时间。
dateTimeModified: Date;属性值
Date
注解
最低权限级别： 读取项
适用的 Outlook 模式：约会与会者
重要提示：Android 版或 iOS 版 Outlook 不支持此属性。 有关 Outlook mobile 中支持的 API 的详细信息，请参阅移动设备上的 Outlook 中支持的 Outlook JavaScript API。
end
获取约会结束的日期和时间。
属性 end 是表示 Date 为协调世界时 (UTC) 日期和时间值的对象。 可以使用 convertToLocalClientTime 方法将 end 属性值转换为客户端的本地日期和时间。
使用 Time.setAsync 方法设置结束时间时，应使用 convertToUtcClientTime 方法将客户端的本地时间转换为服务器的 UTC。
end: Date;属性值
Date
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
from
获取邮件发件人的电子邮件地址。
属性 from 返回 对象 EmailAddressDetails 。
from: EmailAddressDetails;属性值
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
from和sender属性表示同一个人，邮件由代理人发送的除外。 在这种情况下，from属性表示委托器，属性sender表示委托。EmailAddressDetails属性recipientType中from对象的 属性未定义。
internetMessageId
获取消息的 Internet 消息标识符。
internetMessageId: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要提示：在 “已发送邮件” 文件夹中， internetMessageId 最近发送的项目可能尚不可用。 在这种情况下，请考虑使用 Exchange Web Services从服务器获取此属性。
itemClass
获取所选邮件的 Exchange Web Services 项类。
itemClass: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
下表列出了邮件的默认项类。
| Item 类 | 说明 |
|---|---|
| IPM。注意 | 新邮件和邮件答复 |
| IPM。Note.SMIME | 也可以签名的加密邮件 |
| IPM。Note.SMIME.MultipartSigned | 已明文签名的邮件 |
| IPM.Schedule.Meeting.Request | 会议请求 |
| IPM.Schedule.Meeting.Canceled | 会议取消 |
| IPM。Schedule.Meeting.Resp.Neg | 响应以拒绝会议要求 |
| IPM。Schedule.Meeting.Resp.Pos | 接受会议请求的响应 |
| IPM。Schedule.Meeting.Resp.Tent | 响应以暂时接受会议要求 |
可以创建扩展默认项类的自定义类。 例如， IPM.Note.Contoso。
itemId
获取当前 项的 Exchange Web Services 项标识符 。
itemId: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
属性
itemId在撰写模式下不可用。 如果需要项目标识符，Office.context.mailbox.item.saveAsync方法可用于将项目保存到存储，这将在回调函数的asyncResult.value参数中返回项目标识符。 如果项已保存，可以改为调用Office.context.mailbox.item.getItemIdAsync方法。属性返回的
itemId标识符与 Exchange Web 服务项标识符相同。 属性itemId与 Outlook 条目 ID 或 Outlook REST API 使用的 ID 不同。 在使用此值进行 REST API 调用之前，应使用Office.context.mailbox.convertToRestId进行转换。
itemType
获取实例表示的项的类型。
属性 itemType 返回枚举值之 ItemType 一，指示项目对象实例是消息还是约会。
itemType: MailboxEnums.ItemType | string;属性值
Office.MailboxEnums.ItemType | string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
location
获取会议请求的位置。
location 属性返回一个包含约会位置的字符串。
location: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
normalizedSubject
获取项目的主题，删除所有前缀 (包括 RE： 和 FWD：) 。
属性 normalizedSubject 获取项目的主题，其中包含电子邮件程序添加的任何标准前缀 (如 RE： 和 FW：) 。 若要获取包含完整前缀的项目主题，请使用 subject 属性。
normalizedSubject: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
notificationMessages
获取项的通知消息。
notificationMessages: NotificationMessages;属性值
注解
[ API 集：邮箱 1.3 ]
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
-
getAllAsync仅支持 NotificationMessages 对象的 方法。
recurrence
获取约会的重复模式。 获取会议请求的重复模式。 约会项目的读取和撰写模式。 会议请求项的读取模式。
如果项目是系列Recurrence或系列中的实例，则 recurrence 属性返回定期约会或会议请求的对象。
null 返回单个约会和单个约会的会议请求。
undefined 对于未满足请求的邮件，返回 。
recurrence: Recurrence;属性值
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
会议请求的 itemClass 值为
IPM.Schedule.Meeting.Request。recurrence如果对象为 null，则表示对象是单个约会或会议请求，而不是序列的一部分。仅支持 Recurrence 对象的代理和
getAsync方法。
sender
获取电子邮件发件人的电子邮件地址。
sender: EmailAddressDetails;属性值
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
from和sender属性表示同一个人，邮件由代理人发送的除外。 在这种情况下，from属性表示委托器，属性sender表示委托。EmailAddressDetails属性recipientType中sender对象的 属性未定义。
seriesId
获取实例所属的序列的 ID。
在 Outlook 网页版 和 Windows (new 和 classic) 中，seriesId返回此项所属的父 (系列) 项的 Exchange Web Services (EWS) ID。
seriesId: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
seriesId属性返回的标识符与 Exchange Web 服务项目标识符相同。 属性seriesId与 Outlook REST API 使用的 Outlook ID 不同。 在使用此值进行 REST API 调用之前，应使用Office.context.mailbox.convertToRestId进行转换。 有关详细信息，请参阅 使用 Outlook 外接程序中的 Outlook REST API。对于没有父项（如单个约会、系列项目或会议请求）的项目，属性
seriesIdnull返回 ，对于不是会议请求的任何其他项目，则返回undefined。
start
获取约会开始的日期和时间。
属性 start 是表示 Date 为协调世界时 (UTC) 日期和时间值的对象。 可以使用 convertToLocalClientTime 方法将值转换为客户端的本地日期和时间。
start: Date;属性值
Date
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
subject
获取在项的主题字段中显示的说明。
属性 subject 获取电子邮件服务器发送的项的整个主题。
subject 属性返回一个字符串。
normalizedSubject使用 属性获取主题减去任何前导前缀，例如 RE： 和 FW：。
subject: string;属性值
string
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
to
获取邮件的“ 收件人 ”行上的收件人。 提供对邮件的“收件人”行上的收件人的访问权限。 对象的类型和访问级别取决于当前项的模式。
属性to返回一个数组，该数组包含邮件的“收件人”行中列出的每个收件人的 EmailAddressDetails 对象。 返回的最大收件人数因 Outlook 客户端而异。
经典 Windows：500 个收件人
Web 浏览器，新 Outlook：20 个收件人 (折叠视图) ,500 个收件人 (展开视图)
to: EmailAddressDetails[];属性值
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
方法详细信息
displayReplyAllFormAsync(formData, options, callback)
显示一个答复表单，其中包括所选邮件的发件人和所有收件人或组织者以及所选约会的所有与会者。
displayReplyAllFormAsync(formData: string | ReplyFormData, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;参数
- formData
-
string | Office.ReplyFormData
一个包含文本和 HTML 且表示答复窗体的正文的字符串。 字符串限制为 32 KB 或包含正文或附件数据和回调函数的 ReplyFormData 对象。
- options
- Office.AsyncContextOptions
包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们想要访问的任何对象。
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
在Outlook 网页版和新的 Outlook on Windows 中，答复窗体在 3 列视图中显示为弹出窗体，在 2 列或 1 列视图中显示为弹出窗体。
如果任意字符串参数超出其限制，
displayReplyAllFormAsync将引发异常。在 参数中
formData.attachments指定附件时，Outlook 会尝试下载所有附件并将其附加到答复表单。 如果无法添加任何附件，则在窗体 UI 中显示错误。 如果这不可能，则不引发错误消息。
displayReplyAllFormAsync(formData, callback)
显示一个答复表单，其中包括所选邮件的发件人和所有收件人或组织者以及所选约会的所有与会者。
displayReplyAllFormAsync(formData: string | ReplyFormData, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;参数
- formData
-
string | Office.ReplyFormData
一个包含文本和 HTML 且表示答复窗体的正文的字符串。 字符串限制为 32 KB 或包含正文或附件数据和回调函数的 ReplyFormData 对象。
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
在Outlook 网页版和新的 Outlook on Windows 中，答复窗体在 3 列视图中显示为弹出窗体，在 2 列或 1 列视图中显示为弹出窗体。
如果任意字符串参数超出其限制，
displayReplyAllFormAsync将引发异常。在 参数中
formData.attachments指定附件时，Outlook 会尝试下载所有附件并将其附加到答复表单。 如果无法添加任何附件，则在窗体 UI 中显示错误。 如果这不可能，则不引发错误消息。
displayReplyFormAsync(formData, options, callback)
显示答复窗体，其中仅包括所选邮件的发件人或所选约会的组织者。
displayReplyFormAsync(formData: string | ReplyFormData, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;参数
- formData
-
string | Office.ReplyFormData
一个包含文本和 HTML 且表示答复窗体的正文的字符串。 字符串限制为 32 KB 或包含正文或附件数据和回调函数的 ReplyFormData 对象。
- options
- Office.AsyncContextOptions
包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们想要访问的任何对象。
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
在Outlook 网页版和新的 Outlook on Windows 中，答复窗体在 3 列视图中显示为弹出窗体，在 2 列或 1 列视图中显示为弹出窗体。
如果任意字符串参数超出其限制，
displayReplyFormAsync将引发异常。在 参数中
formData.attachments指定附件时，Outlook 会尝试下载所有附件并将其附加到答复表单。 如果无法添加任何附件，则在窗体 UI 中显示错误。 如果这不可能，则不引发错误消息。
displayReplyFormAsync(formData, callback)
显示答复窗体，其中仅包括所选邮件的发件人或所选约会的组织者。
displayReplyFormAsync(formData: string | ReplyFormData, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;参数
- formData
-
string | Office.ReplyFormData
一个包含文本和 HTML 且表示答复窗体的正文的字符串。 字符串限制为 32 KB 或包含正文或附件数据和回调函数的 ReplyFormData 对象。
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
在Outlook 网页版和新的 Outlook on Windows 中，答复窗体在 3 列视图中显示为弹出窗体，在 2 列或 1 列视图中显示为弹出窗体。
如果任意字符串参数超出其限制，
displayReplyFormAsync将引发异常。在 参数中
formData.attachments指定附件时，Outlook 会尝试下载所有附件并将其附加到答复表单。 如果无法添加任何附件，则在窗体 UI 中显示错误。 如果这不可能，则不引发错误消息。
getAllInternetHeadersAsync(options, callback)
以字符串的形式获取消息的所有 Internet 标头。
若要了解详细信息，请参阅在 Outlook 外接程序中获取和设置邮件的 Internet 标头。
getAllInternetHeadersAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;参数
- options
- Office.AsyncContextOptions
包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们想要访问的任何对象。
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。 成功后，Internet 标头数据将在 属性中 asyncResult.value 以字符串的形式提供。 有关返回的字符串值的格式设置信息，请参阅 RFC 2183 。 如果调用失败，属性 asyncResult.error 将包含错误代码，其中包含失败的原因。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
getAllInternetHeadersAsync(callback)
以字符串的形式获取消息的所有 Internet 标头。
若要了解详细信息，请参阅在 Outlook 外接程序中获取和设置邮件的 Internet 标头。
getAllInternetHeadersAsync(callback?: (asyncResult: Office.AsyncResult<string>) => void): void;参数
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。 成功后，Internet 标头数据将在 属性中 asyncResult.value 以字符串的形式提供。 有关返回的字符串值的格式设置信息，请参阅 RFC 2183 。 如果调用失败，属性 asyncResult.error 将包含错误代码，其中包含失败的原因。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
getAsFileAsync(options, callback)
获取以 Base64 编码的 EML 格式的当前消息。
getAsFileAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;参数
- options
- Office.AsyncContextOptions
包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们想要访问的任何对象。
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在回调参数中传递的函数。 属性中 asyncResult.value 返回消息的 Base64 编码 EML 格式。 遇到的任何错误都会在 属性中 asyncResult.error 返回。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
getAsFileAsync(callback)
获取以 Base64 编码的 EML 格式的当前消息。
getAsFileAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;参数
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在回调参数中传递的函数。 属性中 asyncResult.value 返回消息的 Base64 编码 EML 格式。 遇到的任何错误都会在 属性中 asyncResult.error 返回。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
getAttachmentContentAsync(attachmentId, options, callback)
从邮件或约会中获取附件，并将其作为 AttachmentContent 对象返回。
getAttachmentContentAsync(attachmentId: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<AttachmentContent>) => void): void;参数
- attachmentId
-
string
要获取的附件的标识符。
- options
- Office.AsyncContextOptions
包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们想要访问的任何对象。
- callback
-
(asyncResult: Office.AsyncResult<Office.AttachmentContent>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。 如果调用失败，属性 asyncResult.error 将包含错误代码，其中包含失败的原因。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
方法
getAttachmentContentAsync从项中获取具有指定标识符的附件。 最佳做法是，应从 item.attachments 调用获取附件的标识符，然后在同一会话中使用该标识符来检索附件。在Outlook 网页版和新的 Outlook on Windows 中，
getAttachmentContentAsync不支持使用“上传和共享”选项添加的附件。在 Outlook 网页版、移动设备和新的 Outlook on Windows 中，附件标识符仅在同一会话中有效。 当用户关闭应用时，会话结束，或者如果用户开始撰写内联窗体，然后弹出窗体以在单独的窗口中继续。
错误：
AttachmentTypeNotSupported：不支持附件类型。 不支持的类型包括 RTF 格式的嵌入图像，或者电子邮件或日历项目以外的项目附件类型 (，例如联系人或任务项) 。InvalidAttachmentId：附件标识符不存在。
getAttachmentContentAsync(attachmentId, callback)
从邮件或约会中获取附件，并将其作为 AttachmentContent 对象返回。
getAttachmentContentAsync(attachmentId: string, callback?: (asyncResult: Office.AsyncResult<AttachmentContent>) => void): void;参数
- attachmentId
-
string
要获取的附件的标识符。
- callback
-
(asyncResult: Office.AsyncResult<Office.AttachmentContent>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。 如果调用失败，属性 asyncResult.error 将包含错误代码，其中包含失败的原因。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
方法
getAttachmentContentAsync从项中获取具有指定标识符的附件。 最佳做法是，应从 item.attachments 调用获取附件的标识符，然后在同一会话中使用该标识符来检索附件。在Outlook 网页版和新的 Outlook on Windows 中，
getAttachmentContentAsync不支持使用“上传和共享”选项添加的附件。在 Outlook 网页版、移动设备和新的 Outlook on Windows 中，附件标识符仅在同一会话中有效。 当用户关闭应用时，会话结束，或者如果用户开始撰写内联窗体，然后弹出窗体以在单独的窗口中继续。
错误：
AttachmentTypeNotSupported：不支持附件类型。 不支持的类型包括 RTF 格式的嵌入图像，或者电子邮件或日历项目以外的项目附件类型 (，例如联系人或任务项) 。InvalidAttachmentId：附件标识符不存在。
getInitializationContextAsync(options, callback)
获取当 加载项被可作消息激活时传递的初始化数据。
getInitializationContextAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;参数
- options
- Office.AsyncContextOptions
包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们想要访问的任何对象。
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
方法完成后，使用类型的Office.AsyncResult单个参数调用在 参数中callback传递的函数。 成功时，初始化上下文数据以字符串 (或空字符串的形式提供（如果 属性中 asyncResult.value 没有初始化上下文) ）。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
getInitializationContextAsync(callback)
获取当 加载项被可作消息激活时传递的初始化数据。
getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;参数
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
方法完成后，使用类型的Office.AsyncResult单个参数调用在 参数中callback传递的函数。 成功时，初始化上下文数据以字符串 (或空字符串的形式提供（如果 属性中 asyncResult.value 没有初始化上下文) ）。
返回
void
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
getRegExMatches()
返回所选项中与 XML 清单文件中定义的正则表达式匹配的字符串值。
getRegExMatches(): any;返回
any
一个包含匹配在清单 XML 文件中定义的正则表达式的字符串数组的对象。 每个数组的名称等于匹配规则的 RegExName 属性或FilterName匹配ItemHasRegularExpressionMatchItemHasKnownEntity规则的 属性的相应值。 对于 ItemHasRegularExpressionMatch 规则，匹配字符串必须发生在该规则指定的项目的属性中。 简单类型定义支持的属性。
注解
最低权限级别： 读取项
适用的 Outlook 模式：约会与会者
重要说明：
基于实体的上下文 Outlook 加载项现已停用。 但是，仍支持正则表达式规则。 建议更新上下文加载项，以使用正则表达式规则作为替代解决方案。 有关如何实现这些规则的指南，请参阅 上下文 Outlook 加载项。
此方法与 Outlook 加载项的激活规则功能一起使用，Microsoft 365 的统一清单不支持此功能。
如果在项的 body 属性上指定
ItemHasRegularExpressionMatch规则，则正则表达式应进一步筛选正文，并且不应尝试返回项的整个正文。 使用等.*正则表达式获取项的整个正文并不总是返回预期结果。 而是使用Body.getAsync方法检索整个正文。
getRegExMatchesByName(name)
返回所选项中与 XML 清单文件中定义的命名正则表达式匹配的字符串值。
getRegExMatchesByName(name: string): string[];参数
- name
-
string
定义筛选器匹配的 ItemHasRegularExpressionMatch 规则元素的名称。
返回
string[]
一个数组，其中包含与清单 XML 文件中的规则元素中 ItemHasRegularExpressionMatch 定义的正则表达式匹配的字符串，以及指定的 RegExName 元素值。
注解
最低权限级别： 读取项
适用的 Outlook 模式：约会与会者
重要说明：
基于实体的上下文 Outlook 加载项现已停用。 但是，仍支持正则表达式规则。 建议更新上下文加载项，以使用正则表达式规则作为替代解决方案。 有关如何实现这些规则的指南，请参阅 上下文 Outlook 加载项。
此方法与 Outlook 加载项的激活规则功能一起使用，Microsoft 365 的统一清单不支持此功能。
如果在项的 body 属性上指定
ItemHasRegularExpressionMatch规则，则正则表达式应进一步筛选正文，并且不应尝试返回项的整个正文。 使用等.*正则表达式获取项的整个正文并不总是返回预期结果。 而是使用Body.getAsync方法检索整个正文。
getSelectedRegExMatches()
返回与 XML 清单文件中定义的正则表达式匹配的突出显示匹配项中的字符串值。 突出显示的匹配项适用于上下文外接程序。
getSelectedRegExMatches(): any;返回
any
一个包含匹配在清单 XML 文件中定义的正则表达式的字符串数组的对象。 每个数组的名称等于匹配 RegExName 规则的 ItemHasRegularExpressionMatch 属性或匹配 FilterName 规则的 ItemHasKnownEntity 属性的相应值。 对于 ItemHasRegularExpressionMatch 规则，匹配字符串必须发生在该规则指定的项目的属性中。 简单类型定义支持的属性。
注解
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要说明：
基于实体的上下文 Outlook 加载项现已停用。 但是，仍支持正则表达式规则。 建议更新上下文加载项，以使用正则表达式规则作为替代解决方案。 有关如何实现这些规则的指南，请参阅 上下文 Outlook 加载项。
此方法与 Outlook 加载项的激活规则功能一起使用，Microsoft 365 的统一清单不支持此功能。
如果在项的 body 属性上指定
ItemHasRegularExpressionMatch规则，则正则表达式应进一步筛选正文，并且不应尝试返回项的整个正文。 使用 .* 等正则表达式获取项的整个正文并不总是返回预期结果。 而是使用Body.getAsync方法检索整个正文。
getSharedPropertiesAsync(options, callback)
获取共享文件夹或共享邮箱中约会或邮件的属性。
有关使用此 API 的详细信息，请参阅 在 Outlook 外接程序中启用共享文件夹和共享邮箱方案。
getSharedPropertiesAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SharedProperties>) => void): void;参数
- options
- Office.AsyncContextOptions
包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们想要访问的任何对象。
- callback
-
(asyncResult: Office.AsyncResult<Office.SharedProperties>) => void
方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。 属性 asyncResult.value 提供共享项的属性。
返回
void
注解
[ API set： Mailbox 1.8 for shared folder support， Mailbox 1.13 for shared mailbox support ]
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
getSharedPropertiesAsync(callback)
获取共享文件夹或共享邮箱中约会或邮件的属性。
有关使用此 API 的详细信息，请参阅 在 Outlook 外接程序中启用共享文件夹和共享邮箱方案。
getSharedPropertiesAsync(callback: (asyncResult: Office.AsyncResult<SharedProperties>) => void): void;参数
- callback
-
(asyncResult: Office.AsyncResult<Office.SharedProperties>) => void
方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在 参数中callback传递的函数。 属性 asyncResult.value 提供共享项的属性。
返回
void
注解
[ API set： Mailbox 1.8 for shared folder support， Mailbox 1.13 for shared mailbox support ]
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
loadCustomPropertiesAsync(callback, userContext)
异步加载所选项目上此外接程序的自定义属性。
自定义属性以键值对的形式存储在每个应用、每个项目的基础上。 此方法在回调中返回 CustomProperties 对象，该对象提供访问特定于当前项和当前加载项的自定义属性的方法。 自定义属性不会对项进行加密，因此不应将其用作安全存储。
自定义属性作为 asyncResult.value 属性中的 CustomProperties 对象提供。 此对象可用于从邮件项获取自定义属性。
loadCustomPropertiesAsync(callback: (asyncResult: Office.AsyncResult<CustomProperties>) => void, userContext?: any): void;参数
- callback
-
(asyncResult: Office.AsyncResult<Office.CustomProperties>) => void
方法完成后，使用类型的Office.AsyncResult单个参数调用在 参数中callback传递的函数。
- userContext
-
any
可选。 开发人员可以提供他们想要在回调函数中访问的任何对象。 此对象可以通过回调函数中的 asyncResult.asyncContext 属性进行访问。
返回
void
注解
若要了解有关自定义属性的详细信息，请参阅 获取和设置 Outlook 外接程序的外接程序元数据。
最低权限级别： 读取项
适用的 Outlook 模式：邮件读取
重要提示：仅 get 支持 CustomProperties 对象的 和 getAll 方法。
unloadAsync(options, callback)
选择多个邮件项目后，关闭当前加载的项目，以便可以加载另一个选定的邮件项目进行处理。
unloadAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;参数
- options
- Office.AsyncContextOptions
包含 asyncContext 属性的对象文本。 将希望在回调函数中访问的任何对象分配给 asyncContext 属性。
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在回调参数中传递的函数。
返回
void
注解
最低权限级别： 读/写项
适用的 Outlook 模式：邮件Compose
重要说明：
若要了解有关处理多个所选邮件的详细信息，请参阅 在多条消息上激活 Outlook 加载项。
使用
loadItemByIdAsync加载所选邮件项时，必须在处理后调用unloadAsync它。 必须在调用loadItemByIdAsync另一个选定项之前完成此作。
unloadAsync(callback)
选择多个邮件项目后，关闭当前加载的项目，以便可以加载另一个选定的邮件项目进行处理。
unloadAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;参数
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
可选。 方法完成后，使用单个参数 asyncResult（即 Office.AsyncResult 对象）调用在回调参数中传递的函数。
返回
void
注解
最低权限级别： 读/写项
适用的 Outlook 模式：邮件Compose
重要说明：
若要了解有关处理多个所选邮件的详细信息，请参阅 在多条消息上激活 Outlook 加载项。
使用
loadItemByIdAsync加载所选邮件项时，必须在处理后调用unloadAsync它。 必须在调用loadItemByIdAsync另一个选定项之前完成此作。