Procédure pas à pas : création de votre premier complément VSTO pour ProjectWalkthrough: Creating Your First VSTO Add-in for Project

Cette procédure pas à pas vous montre comment créer un complément VSTO pour Microsoft Office Project.This walkthrough shows you how to create an VSTO Add-in for 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.The features that you create in this kind of solution are available to the application itself, regardless of which projects are open. Pour plus d’informations, consultez présentation du développement de Solutions Office (VSTO).For more information, see Office Solutions Development Overview (VSTO).

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de compléments VSTO pour Project.Applies to: The information in this topic applies to VSTO add-in projects for Project. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features Available by Office Application and Project Type.

Cette procédure pas à pas décrit les tâches suivantes :This walkthrough illustrates the following tasks:

  • Création d’un projet de complément VSTO ProjectCreating a Project VSTO Add-in project.

  • Écriture de code qui utilise le modèle objet de Project pour ajouter une tâche à un nouveau projetWriting code that uses the object model of Project to add a task to a new project.

  • Génération et exécution du projet pour le testerBuilding and running the project to test it.

  • Nettoyage du projet terminé, pour que le complément VSTO ne s’exécute plus automatiquement sur votre ordinateur de développementCleaning up the completed project so that the VSTO Add-in no longer runs automatically on your development computer.

    Note

    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.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use determine these elements. Pour plus d'informations, consultez Personnalisation de l'IDE.For more information, see Personalizing the IDE.

PrérequisPrerequisites

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :You need the following components to complete this walkthrough:

Création du projetCreating the Project

Pour créer un projet dans Visual StudioTo create a new project in Visual Studio

  1. Démarrez Visual StudioVisual Studio.Start Visual StudioVisual Studio.

  2. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.On the File menu, point to New, and then click Project.

  3. Dans le volet Modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.In the templates pane, expand Visual C# or Visual Basic, and then expand Office/SharePoint.

  4. Sous le nœud développé Office/SharePoint , sélectionnez le nœud Compléments Office .Under the expanded Office/SharePoint node, select the Office Add-ins node.

  5. Dans la liste des modèles de projet, sélectionnez Complément Project 2010 ou Complément Project 2013.In the list of project templates, select Project 2010 Add-in or Project 2013 Add-in.

  6. Dans la zone Nom , tapez FirstProjectAddIn.In the Name box, type FirstProjectAddIn.

  7. Cliquez sur OK.Click OK.

    Visual StudioVisual Studio crée le projet FirstProjectAddIn et ouvre le fichier de code ThisAddIn dans l’éditeur. creates the FirstProjectAddIn project and opens the ThisAddIn code file in the editor.

Écriture de code qui ajoute une nouvelle tâche à un projetWriting Code that Adds a New Task to a Project

L'étape suivante consiste à ajouter du code au fichier de code ThisAddIn.Next, add code to the ThisAddIn code file. Le nouveau code utilise le modèle objet de Project pour ajouter une nouvelle tâche à un projet.The new code uses the object model of Project to add a new task to a project. Par défaut, le fichier de code ThisAddIn contient le code généré suivant :By default, the ThisAddIn code file contains the following generated code:

  • Une définition partielle de la classe ThisAddIn .A partial definition of the ThisAddIn class. Cette classe fournit un point d’entrée pour votre code et donne accès au modèle objet de Project.This class provides an entry point for your code and provides access to the object model of Project. Pour plus d'informations, consultez Programming VSTO Add-Ins. Le reste de la classe ThisAddIn est défini dans un fichier de code masqué que vous ne devez pas modifier.For more information, see Programming VSTO Add-Ins. The remainder of the ThisAddIn class is defined in a hidden code file that you should not modify.

  • Les gestionnaires d'événements ThisAddIn_Startup et ThisAddIn_Shutdown .The ThisAddIn_Startup and ThisAddIn_Shutdown event handlers. Ces gestionnaires d’événements sont appelés quand Project charge et décharge votre complément VSTO.These event handlers are called when Project loads and unloads your VSTO Add-in. 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é.Use these event handlers to initialize your VSTO Add-in when it is loaded, and to clean up resources used by your VSTO Add-in when it is unloaded. Pour plus d'informations, consultez Events in Office Projects.For more information, see Events in Office Projects.

Pour ajouter une tâche à un nouveau projetTo add a task to a new project

  1. Dans le fichier de code ThisAddIn, ajoutez le code suivant à la classe ThisAddIn .In the ThisAddIn code file, add the following code to the ThisAddIn class. Ce code définit un gestionnaire d’événements pour l’événement NewProject de la classe Microsoft.Office.Interop.MSProject.application.This code defines an event handler for the NewProject event of the Microsoft.Office.Interop.MSProject.Application class.

    Quand l’utilisateur crée un projet, ce gestionnaire d’événements ajoute une tâche au projet.When the user creates a new project, this event handler adds a task to the project.

    Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
        Dim newTask As MSProject.Task
        newTask = pj.Tasks.Add _
        ("This text was added by using code")
        newTask.Start = DateTime.Now
        newTask.Duration = "3"
        newTask.ResourceNames = "Rob Caron, Kelly Krout"
    End Sub
    
    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 :To modify the project, this code example use the following objects:

  • Le champ Application de la classe ThisAddIn .The Application field of the ThisAddIn class. Le Application champ retourne un objet Microsoft.Office.Interop.MSProject.application, qui représente l’instance actuelle du projet.The Application field returns an Microsoft.Office.Interop.MSProject.Application object, which represents the current instance of Project.

  • Le pj paramètre du Gestionnaire d’événements pour l’événement NewProject.The pj parameter of the event handler for the NewProject event. Le pj paramètre est un objet Microsoft.Office.Interop.MSProject.Project, qui représente le projet.The pj parameter is a Microsoft.Office.Interop.MSProject.Project object, which represents the project. Pour plus d'informations, consultez Project Solutions.For more information, see Project Solutions.

  1. En C#, ajoutez le code suivant au gestionnaire d'événements ThisAddIn_Startup .If you are using C#, add the following code to the ThisAddIn_Startup event handler. Ce code connecte le Application_Newproject Gestionnaire d’événements à l’événement NewProject.This code connects the Application_Newproject event handler with the NewProject event.

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

Test du projetTesting the Project

Quand vous générez et exécutez le projet, vérifiez que la nouvelle tâche apparaît dans le nouveau projet obtenu.When you build and run the project, verify that the new task appears in the resulting new project.

Pour tester le projetTo test the project

  1. Appuyez sur F5 pour générer et exécuter votre projet.Press F5 to build and run your project. Microsoft Project démarre et ouvre automatiquement un nouveau projet vide.Microsoft Project starts and automatically opens a new blank project.

    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.When you build the project, the code is compiled into an assembly that is included in the build output folder for the project. 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.Visual Studio also creates a set of registry entries that enable Project to discover and load the VSTO Add-in, and it configures the security settings on the development computer to enable the VSTO Add-in to run. Pour plus d'informations, consultez Vue d'ensemble du processus de génération de solutions Office.For more information, see Office Solution Build Process Overview.

  2. Vérifiez qu’une nouvelle tâche est bien ajoutée au projet vierge.Verify that a new task is added to the blank project.

  3. Vérifiez que le texte suivant s’affiche dans le champ Nom de la tâche de la tâche.Verify that the following text appears in the Task Name field of the task.

    Ce texte a été ajouté via le code.This text was added by using code.

  4. Fermez Microsoft Project.Close Microsoft Project.

Nettoyage du projetCleaning up the Project

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.When you finish developing a project, remove the VSTO Add-in assembly, registry entries, and security settings from your development computer. Sinon, le complément VSTO s’exécute chaque fois que vous ouvrez Microsoft Project sur votre ordinateur.Otherwise, the VSTO Add-in will run every time you open Microsoft Project on the development computer.

Pour nettoyer votre projetTo clean up your project

  1. Dans Visual Studio, dans le menu Générer , cliquez sur Nettoyer la solution.In Visual Studio, on the Build menu, click Clean Solution.

Étapes suivantesNext Steps

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 :Now that you have created a basic VSTO Add-in for Project, you can learn more about how to develop VSTO Add-ins from these topics:

Voir aussiSee Also

Programming VSTO Add-Ins Programming VSTO Add-Ins
Solutions Project Project Solutions
Génération de Solutions Office Building Office Solutions
Déploiement d’une Solution Office Deploying an Office Solution
Vue d’ensemble des modèles de projet OfficeOffice Project Templates Overview