Comment : spécifier un comportement de chargement et des emplacements de symboles
Cette rubrique s'applique à :
Édition |
Visual Basic |
C# |
F# |
C++ |
Web Developer |
|---|---|---|---|---|---|
Express |
.gif "La rubrique s'applique") |
|
|
|
|
Pro, Premium et Ultimate |
|
|
|
|
|
Pour déboguer votre application, le débogueur requiert des informations de symboles qui sont stockées dans des fichiers PDB. Dans certains cas, ces informations peuvent figurer dans des fichiers DBG de format plus ancien. Les fichiers de symboles sont obligatoires pour votre application et pour toute DLL tierce ou système à déboguer. Les fichiers de symboles peuvent être stockés dans un répertoire sur votre ordinateur ou téléchargés à partir d'un serveur de symboles.
Par défaut, le débogueur charge les fichiers de symboles à partir de l'emplacement de votre EXE. Pour utiliser les symboles d'un autre répertoire ou d'un serveur de symboles, vous devez spécifier leur emplacement à Visual Studio.
Visual Studio charge automatiquement les symboles lorsque vous commencez une session de débogage. Vous pouvez spécifier les modules pour lesquels Visual Studio charge automatiquement des symboles. Si vous choisissez de ne pas charger automatiquement de symboles pour tous vos modules, vous pouvez charger manuellement des symboles supplémentaires par l'intermédiaire de la fenêtre Modules.
Pour plus d'informations sur l'utilisation des serveurs de symboles, consultez Comment : utiliser un serveur de symboles. Si vous utilisez un serveur de symboles, assurez-vous qu'il est digne de confiance. Sinon, vous vous exposez à des risques sécuritaires.
Pour spécifier un répertoire où se trouvent les fichiers de symboles
Dans le menu Outils, choisissez Options.
Dans la boîte de dialogue Options, ouvrez le nœud Débogage, puis cliquez sur Symboles.
La page Symboles contient une zone appelée Emplacements du fichier de symboles (.pdb). Au-dessus de cette zone figurent quatre icônes.
Cliquez sur l'icône de dossier.
Le texte modifiable s'affiche dans la zone Emplacements du fichier de symboles (.pdb).
Tapez le chemin d'accès au répertoire. La saisie semi-automatique des instructions vous aide à rechercher le format correct.
Si vous procédez à un débogage distant, les caches des fichiers de symboles et du serveur de symboles du code managé doivent se trouver sur l'ordinateur distant. Les caches des fichiers de symboles et du serveur de symboles du code natif doivent se situer sur l'ordinateur local.
Si vous utilisez des symboles sur un serveur de symboles distant, vous pouvez améliorer les performances en spécifiant un répertoire local dans lequel les symboles peuvent être copiés. Pour ce faire, tapez un chemin d'accès dans la zone Mettre en cache les symboles dans ce répertoire. Si vous déboguez un programme sur un ordinateur distant, le répertoire de cache désigne un répertoire sur cet ordinateur.
Cliquez sur OK.
Pour supprimer un chemin d'accès de la liste des chemins d'accès aux symboles
Ouvrez la boîte de dialogue Options et accédez à la page Symboles, ainsi que décrit dans la procédure précédente.
Sélectionnez un chemin d'accès dans la zone Emplacements du fichier de symboles (.pdb).
Cliquez sur l'icône X rouge.
Cliquez sur OK.
Pour spécifier des symboles à charger automatiquement
Ouvrez la boîte de dialogue Options et accédez à la page Symboles, ainsi que décrit dans la procédure précédente.
Sous Charger automatiquement les symboles pour, cliquez sur Tous les modules, sauf exclus ou Modules spécifiés uniquement.
Si vous avez choisi Tous les modules, sauf exclus, vous pouvez maintenant cliquer sur Spécifier les modules exclus.
La boîte de dialogue Symboles à exclure du chargement automatique apparaît.
Cliquez sur l'icône de document pour ajouter un module à la liste Modules ou sélectionnez un module dans la liste Modules et cliquez sur l'icône X pour le supprimer.
Lorsque vous avez terminé, cliquez sur OK.
Si vous avez choisi Modules spécifiés uniquement, vous pouvez à présent cliquer sur Spécifier les modules.
La boîte de dialogue Symboles à charger automatiquement s'affiche.
Cliquez sur l'icône de document pour ajouter un module à la liste Modules ou sélectionnez un module dans la liste Modules et cliquez sur l'icône X pour le supprimer.
Par défaut, les symboles figurant dans les répertoires où se trouvent vos modules d'application sont toujours chargés. Pour arrêter ce comportement par défaut, désactivez l'option Toujours charger les symboles situés à côté des modules.
Lorsque vous avez terminé, cliquez sur OK.
Cliquez sur OK.
Chargement manuel de symboles
Vous pouvez charger manuellement des symboles à partir de la fenêtre Modules. Cette fonctionnalité n'est pas disponible dans Visual Basic, Visual C# ou Visual Web Developer Express.
Pour charger manuellement les symboles
Cliquez avec le bouton droit sur la fenêtre Modules, pointez sur Charger les symboles à partir de, puis cliquez sur Chemin d'accès aux symboles ou Serveurs de symboles Microsoft.
Le débogueur recherche les symboles dans le chemin d'accès aux symboles ou les serveurs de symboles. Si le débogueur ne trouve pas les symboles, la boîte de dialogue Rechercher des symboles s'affiche.
Dans la boîte de dialogue Rechercher des symboles, trouvez le fichier de symboles que vous souhaitez charger, puis cliquez sur OK.
Le fichier de symboles est un fichier .pdb ou .dbg.
Voir aussi
Référence
Symboles, Débogage, boîte de dialogue Options
Concepts
Fichiers de base de données du programme (C++)
Fichiers de base de données du programme (C#, F# et Visual Basic)
Installation de symboles pour le débogage des incidents d'appel système