ItemEvents_10_Event.BeforeRead イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 イベントの種類
注釈
BeforeRead イベントは、イベントの後に発生しますRead。 Before プレフィックスを持つ他のイベントとは異なり、このイベントは取り消し可能ではありません。 項目がメモリからアンロードされるタイミングを判断するには、 イベントを使用します Unload 。
BeforeRead イベントは、Exchange クライアント拡張機能 (ECE) イベントの IExchExtMessageEvents::OnRead に対応します。
BeforeRead イベントでは、item オブジェクトの次のメンバーのみをアクセスできます。
MAPIOBJECT プロパティは、Outlook オブジェクト モデルでは、非表示のプロパティです。 このプロパティは、基になる MAPI IMessage オブジェクトへのアクセスを提供し、 IUnknown インターフェイスを介してのみ呼び出すことができます。 プロパティは、 IUnknown をサポートする C または C++ などの言語で記述されたプログラムにアクセスできます。 MAPIOBJECT は IDispatch インターフェイスを使用します。 (VBA)、Visual C#、および Visual Basic、Visual Basic for Applications などの開発言語をサポートして、 IDispatch インターフェイスとしない IUnknown 、およびそのため、 MAPIOBJECT にアクセスすることはできません。 他のプロパティまたはメソッドの親アイテムは、このイベントでは、Outlook はエラーを発生させます。
インプリメンターが、基になる IMessage オブジェクトにアクセスし、そのオブジェクトのプロパティを変更すると、Outlook は、IMessage オブジェクトの変更をそのアイテムに反映します。 実装者は 、IMessage オブジェクトの SaveChanges を呼び出して変更を Outlook に反映する必要はありません。
実装者は、イベント、イベントが完了する前に、 MAPIOBJECT プロパティから取得したオブジェクトを解放する必要があります。 イベントのコンテキストの外部には、そのオブジェクトを使用しようとしていますがサポートされていないと、予期しない動作に 。