ItemEvents_10_Event.BeforeRead Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre antes que o Microsoft Outlook comece a ler as propriedades do item.
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 Tipo de evento
Comentários
O evento BeforeRead ocorre após o Read evento. Ao contrário de outros eventos com o prefixo Before , esse evento não é cancelável. Para determinar quando o item é descarregado da memória, use o Unload evento.
O evento BeforeRead corresponde ao evento iexchextmessageevents:: Onread Exchange cliente ECE (extensões).
Os seguintes membros do objeto de item podem ser acessados no evento BeforeRead:
A propriedade MAPIOBJECT é uma propriedade oculta no modelo de objeto do Outlook. Essa propriedade fornece acesso ao objeto subjacente MAPI IMessage e pode ser chamada somente através da interface IUnknown. A propriedade é acessível aos programas escritos em idiomas que suportam IUnknown como C ou C++. MAPIOBJECT não está disponível por meio da interface IDispatch. Idiomas de desenvolvimento, como o Visual Basic for Applications (VBA), Visual c# e Visual Basic oferecem suporte a interface IDispatch e IUnknown e, portanto, eles não podem acessar MAPIOBJECT. Se outras propriedades ou métodos do item pai são acessados nesse caso, o Outlook gerará um erro.
Se o implementador acessa as subjacentes IMessage objeto e altera as propriedades desse objeto, o Outlook será renderizado esse item refletindo as alterações ao objeto IMessage. O implementador não precisará chamar SaveChanges no objeto IMessage para fazer com que as alterações sejam refletidas no Outlook.
Implementadores devem liberar o objeto obtido com a propriedade MAPIOBJECT no evento antes do evento for concluído. Tentando usar esse objeto fora do contexto do evento não é suportado e levarão à redução comportamento imprevisível.