ItemEvents_10_Event.BeforeRead Evento

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

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

ItemEvents_10_BeforeReadEventHandler

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.