Débogage dans les projets au niveau du document

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.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour les applications suivantes : Excel 2007, Excel 2010, Word 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Pour une démonstration vidéo connexe, consultez Comment faire pour déboguer une application VSTO ? (page éventuellement en anglais).

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 Debugging Shortcut Keys, Brief Scheme.

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. Vous pouvez également vous détacher d'abord du processus si vous travaillez toujours dans un document ou une feuille de calcul après l'arrêt du débogueur. Pour plus d'informations sur le détachement d'un processus, consultez Comment : détacher tous les processus.

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 modèle Normal. 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 ne sont pas recréées.

Word verrouille le modèle Normal lorsqu'il est ouvert dans Visual Studio

Lorsque Word est ouvert dans Visual Studio, il verrouille le modèle par défaut Normal. 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, vous ne pouvez pas enregistrer ces modifications car le modèle Normal 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 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 de document Word 2007 selon le format de document (* .doc) Word 97-2003

Pour déboguer un projet de document Word selon le format de document (* .doc) 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.

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.

Résolution des erreurs d'installation à l'aide de l'observateur d'événements

Visual Studio Tools pour Office Runtime écrit des messages dans l'observateur d'événements de Windows, pour toutes les exceptions levées lors de l'installation ou de la désinstallation des solutions Office. Vous pouvez utiliser ces messages pour résoudre les éventuels problèmes d'installation et de déploiement. Pour plus d'informations, consultez Journalisation des événements pour les solutions Office.

Résolution des erreurs de démarrage à l'aide d'un fichier journal et des messages d'erreur

Le Visual Studio Tools pour Office Runtime peut consigner toutes les erreurs qui se produisent au démarrage dans un fichier journal ou afficher chacune d'elles dans une boîte de message. Par défaut, ces options sont désactivées. Vous pouvez activer les options en créant des variables d'environnement.

Pour afficher chaque erreur dans un message, créez une variable d'environnement nommée VSTO_SUPPRESSDISPLAYALERTS et affectez-lui la valeur 0 (zéro). Vous pouvez supprimer les messages en supprimant la variable d'environnement ou en lui affectant la valeur 1 (un).

Pour consigner les erreurs dans un fichier journal, créez une variable d'environnement appelée VSTO_LOGALERTS et affectez-lui la valeur 1 (un). Visual Studio Tools pour Office Runtime crée le fichier journal dans le dossier qui contient le document ou le classeur associé à la personnalisation ou, en cas d'échec, dans le dossier local %TEMP%. Le nom du fichier journal est nom du document.extension.log, par exemple ExcelWorkbook1.xlsx.log. Pour arrêter la journalisation des erreurs, supprimez la variable d'environnement ou affectez-lui la valeur 0 (zéro).

Voir aussi

Tâches

Comment : gérer les erreurs dans les projets Office

Concepts

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

Autres ressources

Débogage dans Visual Studio

Déploiement de solutions Office

Conception et création de solutions Office

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

Historique des modifications