Partager via

Méthodes et propriétés de l’assembly PIA Outlook

  • Article

Cette rubrique décrit comment accéder aux méthodes et propriétés d’un objet dans le code managé à l’aide de l'assembly PIA Outlook (Primary Interop Assembly).

D'où viennent les objets d'assistance ?

Pour créer l'assembly PIA Outlook, Outlook utilise l'outil Type Library Importer (TLBIMP) de .NET Framework pour convertir les définitions de types de la bibliothèque de types COM en définitions équivalentes dans un assembly CLR (Common Language Runtime). Dans COM, un objet est une coclasse formée des éléments suivants :

L'outil TLBIMP importe l'interface principale et l'interface d'événement pour chaque objet et crée un certain nombre d'interfaces, de délégués et de classes, dont les suivants :

À quoi servent les objets d'assistance ?

En continuant à utiliser l’objet FormRegion comme exemple, la liste suivante examine ce que contient chaque interface et classe répertoriées précédemment.

  • L'interface _FormRegion définit toutes les méthodes et propriétés de l'objet FormRegion. Vous n’utiliserez généralement pas cette interface dans le code, à l’exception d’une des conditions décrite ci-dessous.

  • L'interface FormRegionEvents définit des méthodes qui sont mappées à des événements de FormRegion. Vous n’utiliserez pas cette interface dans le code.

  • TLBIMP traite l’interface FormRegionEvents pour créer l’interface FormRegionEvents_Event qui définit tous les événements de FormRegion. Vous n’utiliserez généralement pas cette interface dans le code, à l’exception d’une des conditions décrite ci-dessous.

  • La classe FormRegionClass définit tous les membres (méthodes, propriétés et événements) de FormRegion. Il s'agit de la classe qui est associée à l'interface FormRegion en arrière-plan afin que vous puissiez écrire du code pour créer une instance de l'interface FormRegion. Toutefois, vous n'utilisez pas cette interface directement dans le code.

  • L’interface FormRegion hérite de l’interface _FormRegion et de l’interface FormRegionEvents_Event. La Figure 1 illustre cette relation d'héritage.

    Figure 1. L’interface FormRegion hérite des méthodes et des propriétés de l’interface _FormRegion et hérite des événements de l’interface FormRegionEvents_Event

    L'interface FormRegion hérite des méthodes et des propriétés de l'interface _FormRegion et hérite des événements de l'interface FormRegionEvents_Event

    D’une manière générale, FormRegion est la seule interface que vous utilisez dans le code managé pour accéder à l’objet et aux membres (méthodes, propriétés et événements) de l’objet FormRegion.

Si l'objet Application est maintenant utilisé comme exemple, vous accédez aux objets, méthodes, propriétés et événements de l'objet Application via l'interface Application . Il existe néanmoins trois exceptions pour lesquelles vous devez utiliser une autre interface, ou en fonction du langage, vous voudrez utiliser une autre interface :

  • Lorsque vous accédez à une méthode qui partage le même nom qu'un événement, il est conseillé d'effectuer un cast en interface principale pour appeler la méthode. Par exemple, l’objet Application possède une méthode Quit et un événement Quit. Dans Visual Basic .NET, vous pouvez accéder à la méthode Quit via l’interface Application. En C#, vous pouvez éviter un avertissement du compilateur en cas de conversion de la méthode Quit vers l’interface principale, comme illustré dans l’exemple de code suivant :

        void DemoApp()
    {
        Outlook.Application myApp = new Outlook.Application();
        // Other application code here
        ((Outlook._Application)myApp).Quit();
    }

  • Lorsque vous accédez à un événement qui partage le même nom qu'une méthode de cet objet, vous devez effectuer un cast en interface d'événement appropriée pour vous connecter à l'événement. Comme dans l'exemple ci-dessus, pour vous connecter à l'événement Quit, vous effectuez un cast en interface ApplicationEvents_11_Event .

  • Si vous vous connectez à une version antérieure d'un événement qui a par la suite été étendu dans une version ultérieure d'Outlook, vous devez vous connecter à la version de l'événement dans l'interface antérieure. Par exemple, si vous souhaitez vous connecter à la version de l’événement Quit pour l’objet Application implémenté pour Outlook 2002 au lieu de la dernière version, connectez-vous à l’événement Quit défini dans l’interface ApplicationEvents_10_Event , au lieu de l’événement Quit défini dans l’interface ApplicationEvents_11_Event.

Voir aussi