ItemEvents_10_Event.BeforeRead 事件

定义

命名空间:

Microsoft.Office.Interop.Outlook

程序集:

Microsoft.Office.Interop.Outlook.dll

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

public:
 event Microsoft::Office::Interop::Outlook::ItemEvents_10_BeforeReadEventHandler ^ BeforeRead;

event Microsoft.Office.Interop.Outlook.ItemEvents_10_BeforeReadEventHandler BeforeRead;

Event BeforeRead As ItemEvents_10_BeforeReadEventHandler 

事件类型

ItemEvents_10_BeforeReadEventHandler

注解

BeforeRead 事件在Read事件之后发生。 与具有 Before 前缀的其他事件不同，此事件不可取消。 若要确定项何时从内存中卸载，请使用 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 属性的对象。 尝试使用该对象的事件上下文之外是不受支持，将导致不可预知的行为。