Événement MailItem.BeforeRead (Outlook)

  • Article

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

Syntaxe

expression. BeforeRead

expression Variable qui représente un objet MailItem.

Remarques

L’événement BeforeRead se produit avant l’événement Read. Contrairement aux autres événements comportant le préfixe Before, cet événement ne peut pas être annulé. 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.

Voir aussi

Objet MailItem

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.