Associar o Outlook PIA ao modelo de objeto

O Outlook Primary Interop Assembly (Montagem Interoperacional Principal - PIA) é uma montagem interoperacional oficialmente publicada pelo Outlook que define uma interface gerenciada para suplementos gerenciados para interagir com o modelo de objeto do Outlook baseado em COM. A Introdução à interoperabilidade entre COM e .NET descreve tecnicamente como uma montagem interoperacional suporta uma programação de cliente gerenciado contra uma biblioteca de tipos baseada em COM. Este tópico fornece uma visão geral de como os objetos e membros no modelo de objeto do Outlook baseado em COM são mapeados para as interfaces e classes gerenciadas correspondentes na PIA.

Objetos auxiliares

Quando você compara os objetos da biblioteca de tipos do Outlook listada no pesquisador de objetos do Visual Basic Editor, como na Figura 1, com os objetos da PIA listados no pesquisador de objetos do Visual Studio, como na Figura 2, você pode se sentir sobrecarregado pelo grande número de objetos auxiliares extras que existem na PIA. Você pode notar que alguns objetos, como o objeto Action, mapeiam-se com uma interface, a interface Action, mas outros objetos, como o objeto Account, não se mapeiam necessariamente com uma interface correspondente exata na PIA.

Figura 1. Pesquisador de objetos mostrando objetos na biblioteca de tipos do Outlook baseada em COM

Figura 2. Pesquisador de objetos mostrando objetos no Outlook

Entre essas interfaces, muitas delas têm nomes que começam com um sublinhado ('_') seguido por um nome de objeto. Por exemplo, o objeto Account é mapeado para uma interface pública _Account e uma conta de classe pública no navegador de objetos do Visual Studio. Na verdade, embora não seja mostrado explicitamente no navegador de objetos do Visual Studio, o objeto Account é mapeado para duas interfaces e uma classe na PIA: uma interface _Account , uma coclasse Account e uma classe AccountClass .

Para mais informações sobre esses interfaces, co-classe e classes, de onde elas vêm e como os objetos são mapeados a partir da biblioteca de tipos para a PIA, confira Objetos no Outlook PIA.

Interfaces de eventos separados

Se você examinar os objetos que têm eventos, os eventos na PIA não são agrupados juntos com outro método e membros de propriedade daquele objeto, mas são agrupados para formar suas próprias interfaces, manipuladores de eventos e classes.

Para mais informações sobre como métodos e propriedades são mapeados a partir da biblioteca de tipos para o PIA, confira Métodos e propriedades no Outlook PIA. Para mais informações sobre interfaces de eventos, representantes e classes, confira Eventos no Outlook PIA.

Objetos ocultos e preteridos

O PIA também contém objetos, membros e enumerações que foram preteridos e marcados opcionalmente como ocultos no modelo de objeto COM. A maioria desses objetos, membros e enumerações é exposta na PIA. No entanto, eles são expostos para a completude da PIA; não são mais destinados a serem usados por desenvolvedores de soluções e, portanto, são minimamente documentados. Existem algumas exceções, como os objetos _DocSiteControl e _RecipientControl , que estão ocultos na biblioteca de tipos, mas são expostos e documentados como objetos de primeira classe na referência PIA.

Para obter mais informações sobre o objeto _DocSiteControl , consulte _DDocSiteControl. Para obter mais informações sobre o objeto _RecipientControl , consulte _DRecipientControl.