ContactItem.BeforeRead 事件 (Outlook)

在 Microsoft Outlook 开始读取项目属性之前发生。

语法

expressionBeforeRead

表达 一个代表 ContactItem 对象的变量。

备注

BeforeRead 事件发生之前 读取 事件。 与之前前缀与其他事件,此事件不是可以取消的。 若要确定何时从内存中卸载该项目,请使用 Unload 事件。

BeforeRead 事件对应于 IExchExtMessageEvents::OnRead 的 Exchange 客户端扩展 (ECE) 事件。

BeforeRead 事件中可以访问只有 item 对象的下列成员:

MAPIOBJECT 属性是 Outlook 对象模型中的隐藏的属性。 此属性提供对基础的 MAPI IMessage 对象,并且可以仅通过 IUnknown 接口调用。 该属性是用支持 IUnknown 如 C 或 c + + 语言编写的程序可以访问的。 MAPIOBJECT 不能通过 IDispatch 接口。 如 (VBA)、 视觉 C#,和 Visual Basic 的 Visual Basic for Applications 的开发语言都支持 IDispatch 接口并不为 IUnknown ,,因此,它们无法访问 MAPIOBJECT 。 如果在此事件中访问其他属性或方法的父项,则 Outlook 将引发错误。

如果实现器访问基础 IMessage 对象,并更改了该对象的属性,则 Outlook 将把反映更改的项目呈现给 IMessage 对象。 实现者不必对 IMessage 对象调用 SaveChanges,就会导致更改反映在 Outlook 中。

实现者必须释放来自事件完成前的事件中的 MAPIOBJECT 属性的对象。 尝试使用该对象的事件上下文之外是不受支持,将导致不可预知的行为。

另请参阅

创建 ContactItem 对象

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。