Partager via

Vue d'ensemble du processus de génération de solutions Office

  • Article

Mise à jour : novembre 2007

La génération d'une solution Microsoft Office présente de nombreuses similitudes avec la génération d'autres applications dans Visual Studio. Plusieurs points sont toutefois spécifiques aux solutions Office.

Pour plus d'informations sur la génération d'applications, consultez Génération dans Visual Studio.

Sortie des projets système 2007

L'emplacement de sortie d'un projet de la version 2007 est nomprojet\bin\release ou nomprojet\bin\debug. Vous ne pouvez pas générer de répertoire de déploiement.

Projets au niveau du document

Lorsque vous générez un projet au niveau du document, les éléments suivants sont inclus dans la sortie du projet :

Projets au niveau de l'application

Lorsque vous générez un projet au niveau de l'application, les éléments suivants sont inclus dans la sortie de projet :

Le processus de génération des projets au niveau de l'application crée également, sur l'ordinateur de développement, un jeu d'entrées du Registre nécessaire au chargement du complément. Pour plus d'informations, consultez Entrées du Registre pour les compléments d'application.

Si vous créez un projet de complément Outlook qui contient des régions de formulaire, le processus de génération ajoute les informations supplémentaires suivantes au Registre :

  • Une clé pour chaque classe de message associée à une ou plusieurs zones de formulaire

  • Une entrée pour chaque zone de formulaire et une valeur associée représentant le nom du complément Outlook

Outlook a besoin de ces informations pour charger les régions de formulaire.

Sortie des projets système 2003

L'emplacement de sortie d'un projet de la version 2003 est nomprojet\bin\release ou nomprojet\bin\debug. Vous ne pouvez pas générer de répertoire de déploiement.

Projets au niveau du document

Lorsque vous générez un projet au niveau du document, les éléments suivants sont inclus dans la sortie du projet :

  • Une copie du document de projet.

  • L'assembly de projet et tous les assemblys référencés dont la propriété Copie Locale a la valeur true.

  • Le manifeste d'application (incorporé dans le document). Pour plus d'informations, consultez Manifestes d'application et de déploiement dans les solutions Office.

  • Un fichier PDB (base de données du programme)

Pour les solutions Excel, vous ne pouvez pas modifier le chemin de sortie ni le répertoire de travail. Si vous attribuez un emplacement différent à l'option de répertoire de travail dans le volet Débogage du Concepteur de projets, Excel rétablira l'emplacement par défaut au moment de l'exécution, à l'ouverture du document. Toutefois, pour les solutions Word, vous pouvez modifier le chemin de sortie normalement.

Projets au niveau de l'application

Lorsque vous générez un projet au niveau de l'application, les éléments suivants sont inclus dans la sortie de projet :

Le processus de génération des projets au niveau de l'application crée également, sur l'ordinateur de développement, un jeu d'entrées du Registre nécessaire au chargement du complément. Pour plus d'informations, consultez Entrées du Registre pour les compléments d'application.

Assemblys référencés

Vous pouvez faire référence à des assemblys (notamment aux projets Bibliothèque de classes) depuis votre projet Visual Studio Tools pour Office. Chaque assembly référencé possède une propriété appelée Copie Locale. Copie Locale indique si l'assembly est copié dans le répertoire de sortie. Elle a la valeur true par défaut. Chaque assembly référencé dont la propriété Copie Locale a la valeur true est copié dans le répertoire de sortie.

Sécurité pendant le processus de génération

Visual Studio configure automatiquement les paramètres de sécurité sur l'ordinateur de développement afin d'octroyer des niveaux de confiance à la solution pendant le processus de génération. La solution peut ainsi s'exécuter tandis que vous la déboguez. Les paramètres de sécurité sont gérés de manière différente dans les projets créés pour les différentes versions d'Office.

Projets système 2007

Pour les projets de la version 2007 de Microsoft Office System, Visual Studio Tools pour Office utilise une liste d'inclusion et des certificats pour vérifier l'éditeur. Visual Studio crée automatiquement un certificat temporaire pour identifier des solutions Office et ajoute une entrée à la liste d'inclusion pour approuver ce certificat.

Pour plus d'informations, consultez Sécurité dans les solutions Office (Office System 2007).

Projets système 2003

Pour les projets Microsoft Office 2003, Visual Studio Tools pour Office inclut une propriété booléenne appelée Emplacement des assemblys de confiance. Cette propriété apparaît dans la fenêtre Propriétés de Visual Studio. Par défaut, elle a la valeur True. Si la propriété a la valeur True, lorsque vous générez le projet, Visual Studio accorde un niveau de confiance totale à l'assembly de projet en utilisant l'URL comme preuve.

La confiance totale est également accordée aux assemblys référencés et satellites contenus dans le dossier de sortie. Le niveau de confiance est accordé au niveau de l'utilisateur pour les assemblys présents sur l'ordinateur local. Vous n'avez par conséquent pas besoin d'informations d'identification administratives pour ces projets. Si vous régénérez le projet dans un emplacement différent, les autorisations de confiance totale de l'emplacement précédent sont supprimées. Pour plus d'informations sur la sécurité, consultez Spécifications de sécurité pour exécuter des solutions Office (Office System 2003).

Le fait de vérifier l'emplacement et d'octroyer un niveau de confiance à chaque génération vous permet de déplacer et partager des projets sans devoir à chaque fois modifier manuellement la configuration de la sécurité de l'ordinateur. Vous devez toutefois utiliser les outils fournis par Visual Studio pour modifier l'emplacement de projets. Si vous utilisez un outil externe, tel que l'Explorateur Windows, Visual Studio ne peut pas mettre à jour les autorisations.

Projets en réseau

Si l'assembly ou le document se trouve sur un partage réseau, la mise à jour de la stratégie de sécurité locale (niveau utilisateur) ne suffit pas pour permettre à la solution de s'exécuter. Un administrateur doit accorder la confiance totale au niveau de l'ordinateur aux assemblys et documents situés sur un partage réseau avant que la solution ne s'exécute. Pour plus d'informations sur la définition de la stratégie de sécurité, consultez Comment : accorder des autorisations à des dossiers et des assemblys (Office System 2003).

Pour les projets au niveau du document de la version 2007 de Microsoft Office System, vous devez également ajouter l'emplacement qualifié complet du document à la liste des dossiers Office approuvée. Pour plus d'informations, consultez Octroi de niveaux de confiance à des documents (Office System 2007).

Test d'une personnalisation au niveau du document

Appuyez sur F5 pour générer et déboguer une solution. Si vous souhaitez tester une solution Word 2003 ou Word 2007 sans débogage en générant, puis en ouvrant le document en dehors de Visual Studio, fermez le projet avant d'ouvrir le document. Lorsque vous ouvrez un document Word dans Visual Studio, un indicateur est défini sur le processus Word afin qu'il n'exécute aucune personnalisation. Si vous ouvrez un document Word personnalisé à l'extérieur de Visual Studio en double-cliquant sur le fichier dans l'Explorateur Windows, l'indicateur peut également empêcher ce document d'exécuter des personnalisations. Lorsque vous double-cliquez sur le fichier pour l'ouvrir, Word ouvre le document dans le même processus que les documents en cours d'exécution. Puisqu'un document est ouvert dans Visual Studio, le nouveau document est ouvert dans ce même processus et reçoit l'indicateur lui demandant de ne pas exécuter de personnalisations.

Test d'un complément au niveau de l'application

Appuyez sur F5 pour générer et déboguer une solution. Si vous testez votre complément au niveau de l'application en publiant et en installant la solution, désinstallez celle-ci avant de la publier à nouveau ou d'apporter de nouvelles modifications au code et d'effectuer un nouveau test en appuyant sur F5. Lorsque vous installez une solution publiée, l'assembly du complément est installé dans le cache ClickOnce. Le programme d'installation crée également des clés de Registre de manière à permettre à l'application Office de rechercher et de charger l'assembly. Dans la mesure où la régénération de la solution met à jour les clés de Registre, vous devez désinstaller la première version avant de publier ou d'exécuter la deuxième.

Utilisation de la commande Nettoyer

Pour supprimer les fichiers projet générés de l'ordinateur de développement, vous pouvez utiliser la commande Nettoyer du menu Générer dans Visual Studio. La commande Nettoyer supprime tous les fichiers de l'emplacement de sortie de projet. Pour les projets au niveau de l'application, la commande Nettoyer supprime également les entrées du Registre créées par le processus de génération.

Remarque :

La commande Nettoyer ne supprime pas les autorisations accordées par le processus de génération aux assemblys de solution. Pour plus d'informations sur la suppression d'autorisations, consultez Comment : supprimer des autorisations de dossiers ou d'assemblys (Office System 2003).

Modification de la plateforme en x64

Par défaut, la plateforme cible est Any CPU. Si vous affectez la valeur x64 à la plateforme cible, vous pouvez compiler le projet, mais la solution ne s'exécute pas. La plateforme cible x64 exige l'exécution de la solution dans un processus 64 bits. Office s'exécute dans un processus 32 bits Il ne peut donc pas charger la solution.

Voir aussi

Tâches

Comment : générer des solutions Office

Concepts

Débogage dans les projets au niveau du document

Autres ressources

Génération et débogage de solutions Office

Génération dans Visual Studio