Débogage dans les projets au niveau du document
Mise à jour : novembre 2007
S'applique à |
|---|
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet
Version de Microsoft Office
Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet. |
Vous pouvez déboguer des projets au niveau du document pour Microsoft Office Word et Microsoft Office Excel en utilisant les mêmes outils Visual Studio que ceux que vous utilisez pour d'autres projets. Lorsque vous exécutez le projet en mode débogage, Visual Studio démarre Word ou Excel, et le débogueur est attaché à tout ce qui est en cours d'exécution dans le même processus avec Word ou Excel. Pour plus d'informations sur les outils de débogage Visual Studio, consultez Débogage dans Visual Studio.
.gif "Conseil") Conseil : |
|---|
Pour éviter les conflits, fermez toutes les instances ouvertes de Word ou Excel avant de générer et déboguer un projet. |
Comportement des touches F10 et F11
Lorsque vous commencez à déboguer un projet Office, F10 et F11 n'ont pas le même comportement qu'avec d'autres projets Visual Basic ou C#. Dans des projets Visual Basic ou C#, le débogueur s'arrête sur la fonction principale (main) ; dans des projets Office, Visual Studio n'a pas le contrôle sur la fonction principale de l'application Office. Toutefois, lors du débogage, F10 et F11 ont les mêmes fonctions que dans des projets Visual Basic et C#. Pour plus d'informations, consultez Touches de raccourci de débogage, schéma Brief.
Arrêt du débogueur
Lorsque vous commencez à déboguer un document ou un classeur, le document ou le classeur s'ouvre dans un nouveau processus Word ou Excel. Lorsque vous arrêtez le débogueur, ce dernier met brusquement fin au processus Word ou Excel, ou se détache si vous l'avez configuré pour cela. Tous les autres documents ou classeurs qui sont ouverts dans un processus Word ou Excel qui est alors arrêté sont également fermés sans avertissement, et toute modification non enregistrée est perdue. Cela peut inclure tous les documents ou classeurs qui sont ouverts pendant que le débogueur est en cours d'exécution. Il est préférable de se détacher du processus avant d'arrêter le débogueur, afin de quitter Word et Excel normalement.
Pendant des sessions de débogage intensif, l'arrêt répété du débogueur et la fermeture soudaine de Word peuvent endommager le fichier Normal.dot. Dans ce cas, vous pouvez supprimer le modèle Normal.dot endommagé et il sera recréé automatiquement à la prochaine ouverture de Word. Toutefois, les macros stockées dans le modèle Normal.dot ne sont pas recréées.
Si vous voulez arrêter le débogueur et continuer à travailler dans un document ouvert ou dans une feuille de calcul ouverte, commencez par détacher le débogueur du processus, puis arrêtez le débogueur. Pour plus d'informations, consultez Comment : détacher tous les processus.
Word verrouille Normal.dot lorsqu'il est ouvert dans Visual Studio
Lorsque Word est ouvert dans Visual Studio, il verrouille le modèle par défaut Normal.dot. Lorsque vous exécutez votre solution pour effectuer un débogage, une copie de Word est ouverte dans un autre processus. Si vous apportez des personnalisations au niveau de l'application à la copie ouverte de Word, par exemple en modifiant les barres d'outils ou menus, vous ne pouvez pas enregistrer ces modifications car Normal.dot est verrouillé par le processus ouvert à l'intérieur de Visual Studio.
Au moment de l'exécution, Word ouvre des instances séparées de documents dans un même processus, il est donc moins probable qu'un document ouvert verrouille Normal.dot et empêche des modifications au niveau de l'application.
Pour plus d'informations, consultez l'article de la Base de connaissances « PRB: Prompt to Save Normal.dot When Using Word as an Automation Server » (https://support.microsoft.com/default.aspx?scid=kb;fr-fr;285885).
Débogage de groupes de données mis en cache
À chaque fois que vous générez un projet, le groupe de données est vidé et recréé. Si vous souhaitez déboguer un groupe de données mis en cache, vous devez ouvrir le document en dehors de Visual Studio, puis attacher le débogueur.
Débogage de projets Word 2007 selon le format de document (* .doc) de Word 97-2003
Pour déboguer un projet de document Word 2007 selon le format de document (* .doc) de Word 97-2003, vous devez ajouter le dossier du projet à la liste des dossiers approuvée. Pour plus d'informations sur la façon de procéder, consultez Octroi de niveaux de confiance à des documents (Office System 2007).
Contrôle de code source
Les propriétés de débogage ne sont pas partagées entre plusieurs utilisateurs sous contrôle de code source. Les projets Visual Basic et C# stockent les propriétés de débogage dans un fichier spécifique à l'utilisateur (<NomProjet>.vbproj.user ou <NomProjet>.csproj.user), et ce fichier n'est pas sous contrôle de code source. Si plusieurs personnes effectuent un débogage, chacune d'entre elles doit entrer manuellement les propriétés de débogage.
Arguments de la ligne de commande
Si Action de démarrage sur la page de propriétés Déboguer a la valeur Démarrer le projet, Visual Studio n'utilise pas d'arguments de ligne de commande lors du débogage du projet, même si vous avez spécifié des arguments de ligne de commande comme options de démarrage. Si vous souhaitez utiliser des arguments de ligne de commande lorsque vous démarrez le débogage, vous devez sélectionner une Action de démarrage autre que Démarrer le projet.
Dépannage à l'aide d'un journal et de messages d'erreur
Visual Studio Tools pour Office peut écrire toutes les erreurs dans un fichier journal. Par défaut, cette option est désactivée pour les projets Word et Excel. Vous pouvez activer cette option en ajoutant la variable d'environnement VSTO_LOGALERTS et en lui affectant la valeur 1 (un). Visual Studio Tools pour Office crée le fichier journal dans le dossier de sortie où le document de la solution est créé ou, si cette opération échoue, dans le dossier %TEMP%. Le nom par défaut du fichier journal est <NomDocument>.doc.log pour Word et <NomDocument>.xls.log pour Excel. Vous pouvez arrêter la journalisation des erreurs en affectant la valeur 0 (zéro) à la variable.
Visual Studio Tools pour Office affiche par défaut chaque erreur dans un message pour les projets Word et Excel. Pour que Visual Studio Tools pour Office cesse d'afficher des messages d'erreur, ajoutez la variable d'environnement VSTO_SUPPRESSDISPLAYALERTS et affectez-lui la valeur 1 (un). Pour afficher des messages d'erreur, affectez la valeur 0 (zéro) à la variable.
Pour plus d'informations sur les variables d'environnement dans Microsoft Windows XP, consultez « Comment : gérer les variables d'environnement dans Windows XP » (https://support.microsoft.com/default.aspx?scid=kb;fr-fr;310519).
Voir aussi
Tâches
Comment : gérer les erreurs dans les projets Office
Concepts
Déploiement de solutions Office (Office System 2003)
Déploiement de solutions Office (Office System 2007)
Création de solutions Office dans Visual Studio
Vue d'ensemble du processus de génération de solutions Office