Zuordnen der Outlook-PIA zum Objektmodell
Die primäre Interopassembly (Primary Interop Assembly, PIA) von Outlook ist eine offiziell von Outlook veröffentlichte Interopassembly, die eine verwaltete Schnittstelle für die Interaktion von verwalteten Add-Ins mit dem COM-basierten Outlook-Objektmodell definiert. In Einführung in die Interoperabilität zwischen COM und .NET wird beschrieben, wie eine Interopassembly technisch die Programmierung eines verwalteten Clients mit einer COM-basierten Typbibliothek unterstützt. In diesem Thema lesen Sie, wie Objekte und Member im COM-basierten Outlook-Objektmodell den entsprechenden verwalteten Schnittstellen und Klassen in der PIA zugeordnet sind.
Hilfsobjekte
Wenn Sie die Objekte der Outlook-Typbibliothek, die, wie in Abbildung 1 dargestellt, im Objektkatalog des Visual Basic-Editors aufgeführt sind, mit den Objekten der PIA vergleichen, die im Objektkatalog von Visual Studio aufgeführt sind (wie in Abbildung 2 dargestellt), werden Sie erstaunt sein, wie viele zusätzliche Hilfsobjekte in der PIA vorhanden sind. Sie werden feststellen, dass einige Objekte, z. B. das Action-Objekt, einer Schnittstelle zugeordnet ist, und zwar der Action-Schnittstelle, dass aber andere Objekte, z. B. das Account-Objekt nicht unbedingt genau einer entsprechenden Schnittstelle in der PIA zugeordnet sind.
Abbildung 1: Objektkatalog mit Objekten in der COM-basierten Outlook-Typbibliothek
Abbildung 2: Objektkatalog mit Objekten in Outlook
Viele von diesen Schnittstellen haben Namen, die mit einem Unterstrich ("_") beginnen, auf den ein Objektname folgt. Beispielsweise ist das Account-Objekt im Visual Studio-Objektbrowser einer öffentlichen Schnittstelle _Account und einer öffentlichen Klasse Account zugeordnet. Tatsächlich ist das Account-Objekt zwei Schnittstellen und einer Klasse in der PIA zugeordnet, auch wenn dies im Visual Studio-Objektbrowser nicht explizit angezeigt wird: einer _Account -Schnittstelle, einer Account -Co-Klasse und einer AccountClass -Klasse.
Weitere Informationen zu diesen Schnittstellen, Co-Klassen und Klassen, woher sie stammen und wie Objekte von der Typbibliothek auf die PIA abgebildet werden, finden Sie unter Objekte in der Outlook-PIA.
Separate Ereignisschnittstellen
Wenn Sie einmal Objekte betrachten, die Ereignisse enthalten, so stellen Sie fest, dass Ereignisse in der PIA nicht mit anderen Methoden- und Eigenschaftsmembern dieses Objekts zusammen gruppiert sind, sondern getrennt, sodass sie eigene Schnittstellen, Ereignishandler und Klassen bilden.
Weitere Informationen dazu, wie Methoden und Eigenschaften von der Typbibliothek auf die PIA abgebildet werden, finden Sie unter Methoden und Eigenschaften in der Outlook-PIA. Weitere Informationen zu Ereignisschnittstellen, Stellvertretungen und Klassen finden Sie unter Ereignisse in der Outlook-PIA.
Verborgene und veraltete Objekte
Die PIA enthält auch Objekte, Member und Enumerationen, die veraltet sind und optional als ausgeblendet im COM-Objektmodells gekennzeichnet wurden. Die meisten dieser Objekte, Member und Enumerationen werden in der PIA verfügbar gemacht – allerdings nur aus Gründen der Vollständigkeit der PIA. Sie sollen von Lösungsentwicklern nicht mehr verwendet werden und sind deshalb nur minimal dokumentiert. Es gibt einige Ausnahmen, z. B. das _DocSiteControl-Objekt und das _RecipientControl-Objekt, die in der Typbibliothek verborgen sind, aber als erste Klassenobjekte verfügbar gemacht werden und in der PIA-Referenz entsprechend dokumentiert sind.
Weitere Informationen zum _DocSiteControl-Objekt finden Sie unter _DDocSiteControl. Weitere Informationen zum _RecipientControl-Objekt finden Sie unter _DRecipientControl.