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

  • Article

Cette procédure pas à pas vous montre comment créer un complément VSTO pour Microsoft Office Project. Les fonctionnalités que vous créez dans ce type de solution sont accessibles à l’application proprement dite, quels que soient les projets ouverts. 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 Project. 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 Project

  • Écriture de code qui utilise le modèle objet de Project pour ajouter une tâche à un nouveau projet

  • 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

    Remarque

    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 Personnaliser l’IDE.

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

Créer le projet

Pour créer un projet 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 Complément Project 2010 ou Complément Project 2013.

  6. Dans la zone Nom , tapez FirstProjectAddIn.

  7. Cliquez sur OK.

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

Écritre du code qui ajoute une nouvelle tâche à un projet

L'étape suivante consiste à ajouter du code au fichier de code ThisAddIn. Le nouveau code utilise le modèle objet de Project pour ajouter une nouvelle tâche à un projet. 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 donne accès au modèle objet de Project. Pour plus d’information, consultez Programmer des 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 Project 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 une tâche à un nouveau projet

  1. 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 NewProject de la classe Microsoft.Office.Interop.MSProject.Application.

    Quand l’utilisateur crée un projet, ce gestionnaire d’événements ajoute une tâche au projet.

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

    Pour modifier le projet, cet exemple de code utilise les objets suivants :

  • Le champ Application de la classe ThisAddIn . Le champ Application retourne un objet Microsoft.Office.Interop.MSProject.Application qui représente l’instance active de Project.

  • Le paramètre pj du gestionnaire d'événements pour l'événement NewProject. Le paramètre pj est un objet Microsoft.Office.Interop.MSProject.Project qui représente le projet. Pour plus d'informations, consultez Solutions Project.

  1. En C#, ajoutez le code suivant au gestionnaire d'événements ThisAddIn_Startup . Ce code connecte le gestionnaire d'événements Application_Newproject à l'événement NewProject.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

Tester le projet

Quand vous générez et exécutez le projet, vérifiez que la nouvelle tâche apparaît dans le nouveau projet obtenu.

Pour tester le projet

  1. Appuyez sur F5 pour générer et exécuter votre projet. Microsoft Project démarre et ouvre automatiquement un nouveau projet vide.

    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 aussi un jeu d’entrées de Registre qui permet à Project de détecter et de charger le complément VSTO, puis configure les paramètres de sécurité sur l’ordinateur de développement pour permettre l’exécution du complément VSTO. Pour plus d'informations, consultez Vue d'ensemble du processus de génération d'une solution Office..

  2. Vérifiez qu’une nouvelle tâche est bien ajoutée au projet vierge.

  3. Vérifiez que le texte suivant s’affiche dans le champ Nom de la tâche de la tâche.

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

  4. Fermez Microsoft Project.

Nettoyer le projet

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écute chaque fois que vous ouvrez Microsoft Project sur votre ordinateur.

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 Project, vous pouvez en savoir plus sur le développement des compléments VSTO en consultant les rubriques suivantes :

Contenu connexe