Procédure pas à pas : création de votre premier complément VSTO pour Outlook
Réduire la table des matières
Développer la table des matières
Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

Procédure pas à pas : création de votre premier complément VSTO pour Outlook

 

Cette procédure pas à pas montre comment créer un complément VSTO pour Microsoft Office Outlook. Les fonctionnalités que vous créez dans ce type de solution sont accessibles à l'application elle-même, quel que soit l'élément Outlook ouvert. Pour plus d'informations, consultez Vue d'ensemble du développement des solutions Office (VSTO).

S'applique à : les informations contenues dans cette rubrique s'appliquent aux projets de compléments VSTO pour Outlook. Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Cette procédure pas à pas décrit les tâches suivantes :

  • Création d’un projet de complément VSTO Outlook pour Outlook.

  • Écriture du code qui utilise le modèle objet d'Outlook pour ajouter du texte à l'objet et au corps d'un nouveau message électronique.

  • Génération et exécution du projet pour le tester

  • Nettoyage du projet terminé, pour que le complément VSTO ne s'exécute plus automatiquement sur votre ordinateur de développement.

System_CAPS_noteRemarque

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Personnalisation de l'IDE de Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

Pour créer un projet Outlook dans Visual Studio

  1. Démarrez Visual Studio.

  2. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

  3. Dans le volet Modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.

  4. Sous le nœud développé Office/SharePoint, sélectionnez le nœud Compléments Office.

  5. Dans la liste des modèles de projet, sélectionnez un projet de complément VSTO Outlook.

  6. Dans la zone Nom, tapez FirstOutlookAddIn.

  7. Click

    Visual Studio crée le projet FirstOutlookAddIn et ouvre le fichier de code ThisAddIn dans l'éditeur.

L'étape suivante consiste à ajouter du code au fichier de code ThisAddIn. Le nouveau code utilise le modèle objet d'Outlook pour ajouter du texte à chaque nouveau message électronique. Par défaut, le fichier de code ThisAddIn contient le code généré suivant :

  • Une définition partielle de la classe ThisAddIn. Cette classe fournit un point d'entrée pour votre code et offre un accès au modèle objet d'Outlook. Pour plus d'informations, consultez Programmation de compléments VSTO. Le reste de la classe ThisAddIn est défini dans un fichier de code masqué que vous ne devez pas modifier.

  • Les gestionnaires d'événements ThisAddIn_Startup et ThisAddIn_Shutdown. Ces gestionnaires d’événements sont appelés quand Outlook charge et décharge votre complément VSTO. Utilisez ces gestionnaires d'événements pour initialiser votre complément VSTO quand il est chargé, ainsi que pour nettoyer les ressources utilisées par votre complément VSTO quand il est déchargé. Pour plus d'informations, consultez Événements dans les projets Office.

Pour ajouter du texte à l'objet et au corps de chaque nouveau message électronique

  1. Dans le fichier de code ThisAddIn, déclarez un champ nommé inspectors dans la classe ThisAddIn. Le champ inspectors conserve une référence à la collection de fenêtres Inspecteur de l'instance Outlook actuelle. Cette référence empêche le garbage collector de libérer la mémoire qui contient le gestionnaire d'événements pour l'événement E:Microsoft.Office.Interop.Outlook.InspectorsEvents_Event.NewInspector.

    Outlook.Inspectors inspectors;
    
  2. Remplacez la méthode ThisAddIn_Startup par le code suivant. Ce code attache un gestionnaire d'événements à l'événement E:Microsoft.Office.Interop.Outlook.InspectorsEvents_Event.NewInspector.

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
    {
        inspectors = this.Application.Inspectors;
        inspectors.NewInspector +=
        new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
    }
    
  3. Dans le fichier de code ThisAddIn, ajoutez le code suivant à la classe ThisAddIn. Ce code définit un gestionnaire d'événements pour l'événement E:Microsoft.Office.Interop.Outlook.InspectorsEvents_Event.NewInspector.

    Lorsque l'utilisateur crée un message électronique, ce gestionnaire d'événements ajoute du texte à l'objet et au corps du message.

    void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
    {
        Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
        if (mailItem != null)
        {
            if (mailItem.EntryID == null)
            {
                mailItem.Subject = "This text was added by using code";
                mailItem.Body = "This text was added by using code";
            }
    
        }
    }
    

Pour modifier chaque nouveau message électronique, les exemples de code précédents utilisent les objets suivants :

Lorsque vous générez et exécutez le projet, vérifiez que le texte s'affiche dans la ligne d'objet et le corps d'un nouveau message électronique.

Pour tester le projet

  1. Appuyez sur F5 pour générer et exécuter votre projet.

    Quand vous générez le projet, le code est compilé dans un assembly qui est inclus dans le dossier de sortie de la génération du projet. Visual Studio crée également un jeu d’entrées de Registre qui permet à Outlook de détecter et de charger le complément VSTO, et il configure les paramètres de sécurité de l’ordinateur de développement pour permettre au complément VSTO de s’exécuter. Pour plus d'informations, consultez Office Solution Build Process Overview.

  2. Dans Outlook, créez un nouveau message électronique.

  3. Vérifiez que le texte suivant est ajouté à la ligne d'objet et au corps du message.

    Ce texte a été ajouté via le code.

  4. Fermez Outlook.

Une fois que vous avez terminé de développer un projet, supprimez l'assembly du complément VSTO, les entrées de Registre et les paramètres de sécurité de votre ordinateur de développement. Sinon, le complément VSTO s’exécutera chaque fois que vous ouvrirez Outlook sur l’ordinateur de développement.

Pour nettoyer votre projet

  1. Dans Visual Studio, dans le menu Générer, cliquez sur Nettoyer la solution.

Étapes suivantes

Maintenant que vous avez créé un complément VSTO de base pour Outlook, vous pouvez perfectionner votre connaissance du développement des compléments VSTO en consultant les rubriques suivantes :

Afficher:
© 2016 Microsoft