Procédure pas à pas : création de votre premier complément d'application pour Outlook

Article
03/04/2013

Cette procédure pas à pas vous indique comment créer un complément d'application pour Microsoft Office Outlook.Les fonctionnalités créées dans ce type de solution sont disponibles pour l'application, quel que soit l'élément Outlook ouvert.Pour plus d’informations, consultez Vue d'ensemble du développement des solutions Office.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau application pour Outlook 2013 et Outlook 2010. Pour en savoir plus, 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 Outlook pour Outlook
Écriture de 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é afin que le complément ne s'exécute plus automatiquement sur votre ordinateur de développement.

[!REMARQUE]

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio 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 Paramètres Visual Studio.

Composants requis

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

Une édition de Visual Studio 2012 qui inclut les outils de développement Microsoft Office. Pour plus d'informations, consultez [Configuration d'un ordinateur pour développer des solutions Office](bb398242\(v=vs.110\).md).

Outlook 2013 ou Outlook 2010.

Création du projet

Pour créer un projet Outlook dans Visual Studio

Démarrez Visual Studio.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans le volet modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.
Sous le nœud développé Office/SharePoint , sélectionnez le nœud Les compléments Office .
Dans la liste des modèles de projet, sélectionnez Complément Outlook 2010 ou Complément Outlook 2013.
Dans la zone Nom, tapez FirstOutlookAddIn.
Cliquez sur OK.

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

Écriture de code qui ajoute du texte à chaque nouveau message électronique

L'étape suivante consiste à ajouter du code dans le 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 d'application.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 lorsque Outlook charge et décharge votre complément.Utilisez ces gestionnaires d'événements pour initialiser votre complément lorsqu'il est chargé et pour nettoyer les ressources utilisées par votre complément lorsqu'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

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 dans 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 NewInspector.
```
Private WithEvents inspectors As Outlook.Inspectors
```
```
Outlook.Inspectors inspectors;
```

Remplacez la méthode ThisAddIn_Startup par le code suivant.Ce code joint un gestionnaire d'événements à l'événement NewInspector.

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    inspectors = Me.Application.Inspectors
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    inspectors = this.Application.Inspectors;
    inspectors.NewInspector +=
    new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
}

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 NewInspector.

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

Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
    Dim mailItem As Outlook.MailItem = TryCast(Inspector.CurrentItem, Outlook.MailItem)
    If Not (mailItem Is Nothing) Then
        If mailItem.EntryID Is Nothing Then
            mailItem.Subject = "This text was added by using code"
            mailItem.Body = "This text was added by using code"
        End If
    End If
End Sub

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 :

Le champ Application de la classe ThisAddIn.Le champ Application retourne un objet Application, qui représente l'instance actuelle d'Outlook.
Le paramètre Inspector du gestionnaire d'événements pour l'événement NewInspector.Le paramètre Inspector est un objet Inspector, qui représente la fenêtre Inspecteur du nouveau message électronique.Pour plus d’informations, consultez Solutions Outlook.

Test du projet

Lorsque vous générez et exécutez le projet, vérifiez que le texte apparaît dans la ligne Objet et dans le corps d'un nouveau message électronique.

Pour tester le projet

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

Lorsque vous générez le projet, le code est compilé dans un assembly qui est inclus dans le dossier de sortie correspondant.Visual Studio crée également un jeu d'entrées du Registre qui permet à Outlook de détecter et de charger le complément. En outre, il configure les paramètres de sécurité de l'ordinateur de développement pour permettre au complément de s'exécuter.Pour plus d’informations, consultez Procédure pas à pas : création de votre premier complément d'application pour Outlook.
Dans Outlook, créez un message électronique.
Vérifiez que le texte suivant est ajouté à la fois à la ligne Objet et au corps du message.

Ce texte a été ajouté en utilisant le code.
Fermez Outlook.

Nettoyage du projet

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

Pour nettoyer votre projet

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

Étapes suivantes

Maintenant que vous avez créé un complément d'application de base pour Outlook, vous pouvez perfectionner votre connaissance du développement de compléments en consultant ces rubriques :

Tâches de programmation générales que vous pouvez exécuter en utilisant des compléments pour Outlook.Pour plus d’informations, consultez Programmation de compléments d'application.
Utilisation du modèle objet d'Outlook.Pour plus d’informations, consultez Solutions Outlook.
Personnalisation de l'interface utilisateur d'Outlook en ajoutant par exemple un onglet personnalisé au ruban ou en créant votre propre volet de tâches personnalisé.Pour plus d’informations, consultez Personnalisation de l'interface utilisateur Office.
Génération et débogage des compléments d'application pour Outlook.Pour plus d’informations, consultez Génération de solutions Office.
Déploiement de compléments d'application pour Outlook.Pour plus d’informations, consultez Déploiement d'une solution Office.