ItemEvents_10_Event.BeforeRead Événement

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Se produit avant que Microsoft Outlook commence à lire les propriétés de l’élément.

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 

Type d'événement

ItemEvents_10_BeforeReadEventHandler

Remarques

L’événement BeforeRead se produit après l’événement Read . Contrairement à d’autres événements avec le préfixe Before , cet événement n’est pas annulable. Pour déterminer quand l’élément est déchargé de la mémoire, utilisez l’événement Unload .

L’événement BeforeRead correspond à l’événement ECE (Extensions de client Exchange) IExchExtMessageEvents::OnRead.

Seuls les membres suivants de l’objet d’élément sont accessibles dans l’événement BeforeRead :

La propriété MAPIOBJECT est une propriété masquée dans le modèle d’objet Outlook. Cette propriété fournit l’accès à l’objet IMessage MAPI sous-jacent et peut être appelée uniquement via l’interface IUnknown. La propriété est accessible aux programmes écrits dans des langages tels que C ou C++ qui prennent en charge IUnknown. MAPIOBJECT n’est pas disponible via l’interface IDispatch. Les langages de développement tels que Visual Basic pour Applications (VBA), Visual C# et Visual Basic prennent en charge l’interface IDispatch et non IUnknown. Par conséquent, ils ne peuvent pas accéder à MAPIOBJECT. Si d’autres propriétés ou méthodes de l’élément parent sont utilisées dans cet événement, Outlook génère une erreur.

Si le responsable de l’implémentation accède à l’objet IMessage sous-jacent et change les propriétés de cet objet, Outlook affichera cet élément en reflétant les modifications apportées à l’objet IMessage. L’implémenteur n’a pas besoin d’appeler SaveChanges sur l’objet IMessage pour que les modifications soient reflétées dans Outlook.

Les implémenteurs doivent libérer l’objet obtenu à partir de la propriété MAPIOBJECT dans l’événement avant la fin de l’événement. Les tentatives d’utilisation de cet objet hors du contexte de l’événement ne sont pas prises en charge et peuvent mener à des comportements imprévisibles.