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

Article
03/04/2013

Cette procédure pas à pas vous indique comment créer un complément d'application pour Microsoft Office Project.Les fonctionnalités créées dans ce type de solution sont disponibles pour l'application, quels que soient les projets ouverts.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 Project 2013 et Project 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 de projet
É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é 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).

Project 2013 ou Project 2010.

Création du projet

Pour créer un projet 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 Project 2010 ou Complément Project 2013.
Dans la zone Nom, tapez FirstProjectAddIn.
Cliquez sur OK.

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

Écriture de code qui ajoute une nouvelle tâche à un projet

L'étape suivante consiste à ajouter du code dans le fichier de code ThisAddIn.Le nouveau code utilise le modèle objet de Project pour ajouter une tâche à un nouveau 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 offre un accès au modèle objet de Project.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 Project 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 une tâche au projet

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.

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

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 :

Le champ Application de la classe ThisAddIn.Le champ Application retourne un objet Microsoft.Office.Interop.MSProject.Application qui représente l'instance actuelle 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 de projet.

Si vous utilisez 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);
```

Test du projet

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

Pour tester le projet

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

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 permettent à Project 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 afin de permettre l'exécution du complément.Pour plus d’informations, consultez Office Solution Build Process Overview.
Vérifiez qu'une nouvelle tâche est ajoutée au projet vierge.
Vérifiez que le texte suivant apparaît dans le champ Nom de tâche de la tâche.

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

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 ouvrirez Microsoft Project 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 Project, 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 dans les compléments pour Project : Programmation de compléments d'application.
Utilisation du modèle objet de Project : Solutions de projet.
Génération et débogage des compléments d'application pour Project : Génération de solutions Office.
Déploiement de compléments d'application pour Project : Déploiement d'une solution Office.