Procédure : Spécifier les emplacements du fichier de symboles à partir de la ligne de commandeHow to: Specify symbol file locations from the command line

Pour pouvoir afficher des informations de symboles telles que les noms de fonctions et les numéros de ligne, l’outil en ligne de commande VSPerfReport nécessite l’accès aux fichiers de symboles (.pdb) des composants profilés, ainsi qu’aux fichiers système Windows.To display symbol information such as function names and line numbers, the VSPerfReport command-line tool requires access to the symbol (.pdb) files of the profiled components and the Windows system files. Les fichiers de symboles sont créés lors de la compilation d’un composant.Symbol files are created when a component is compiled. Pour plus d’informations, consultez VSPerfReport.For more information, see VSPerfReport. VSPerfReport recherche automatiquement les fichiers de symboles dans les emplacements suivants :VSPerfReport automatically searches the following locations for symbol files:

  • Chemins spécifiés dans l’option /SymbolPath ou dans la variable d’environnement _NT_SYMBOL_PATH.Paths specified in the /SymbolPath option or in the _NT_SYMBOL_PATH environment variable.

  • Chemin local exact dans lequel un composant a été compilé.The exact local path where a component was compiled.

  • Répertoire contenant le fichier de données de profilage (fichier .vsp ou .vsps).The directory that contains the profiling data (.vsp or .vsps) file.

    Microsoft fournit les fichiers .pdb d’un grand nombre de ses produits en ligne sur un serveur de symboles.Microsoft provides the .pdb files for many of its products online in a symbol server. Si l’ordinateur que vous utilisez pour la génération de rapports est connecté à Internet, VSPerfReport se connecte au serveur de symboles en ligne afin de rechercher automatiquement les informations de symboles et d’enregistrer les fichiers dans un magasin local.If the computer that you are using for reporting is connected to the Internet, VSPerfReport connects to the online symbol server to automatically look up symbol information and save the files to a local store.

    Vous pouvez spécifier l’emplacement des fichiers de symboles et de la banque de serveurs de symboles Microsoft en procédant de l’une des manières suivantes :You can specify the location of symbol files and the Microsoft symbol server store in the following ways:

  • Définissez la variable d’environnement _NT_SYMBOL_PATH.Set the _NT_SYMBOL_PATH environment variable.

  • Ajoutez l’option /SymbolPath à la ligne de commande de VSPerfReport.Add the /SymbolPath option to the VSPerfReport command line.

    Vous pouvez également combiner ces deux méthodes.You can also use both of these methods.

Note

Si Visual StudioVisual Studio est installé sur l’ordinateur local, un emplacement pour les fichiers de symboles Windows a probablement déjà été défini.If Visual StudioVisual Studio is installed on the local computer, a location for the Windows symbol files probably has been specified already. Pour plus d'informations, voir Procédure : référencer les informations de symboles Windows.For more information, see How to: Reference Windows symbol information. Vous devez toujours configurer VSPerfReport pour utiliser l’emplacement et le serveur comme décrit plus loin dans cette rubrique.You must still configure VSPerfReport to use the location and server as described later in this topic.

Spécifier des fichiers de symboles WindowsSpecify Windows symbol files

Pour configurer l’utilisation du serveur de symboles WindowsTo configure the use of the Windows symbol server

  1. Si nécessaire, créez un répertoire dans lequel stocker les fichiers de symboles localement.If necessary, create a directory to store the symbol files locally.

  2. Utilisez la syntaxe suivante pour définir la variable d’environnement _NT_SYMBOL_PATH ou l’option VSPerfReport /SymbolPath :Use the following syntax to set the _NT_SYMBOL_PATH environment variable or the VSPerfReport /SymbolPath option:

    SRV\* LocalStore *http://msdl.microsoft.com/downloads/symbolssrv\* LocalStore *http://msdl.microsoft.com/downloads/symbols

    LocalStore est le chemin du répertoire local que vous avez créé.where LocalStore is the path of the local directory that you created.

Spécifier des fichiers de symboles de composantsSpecify component symbol files

Les Outils de profilage recherchent les fichiers .pdb des composants que vous souhaitez profiler dans leurs emplacements d’origine, qui sont stockés dans les composants ou dans le dossier contenant le fichier de données de profilage.Profiling Tools searches for the.pdb files of the components that you want to profile in their original locations that are stored in the components or in the folder that contains the profiling data file. Vous pouvez spécifier d’autres emplacements dans lesquels effectuer la recherche en ajoutant un ou plusieurs chemins à _NT_SYMBOL_PATH ou à l’option /SymbolPath.You can specify other locations to search by adding one or more paths to _NT_SYMBOL_PATH or to the /SymbolPath option. Séparez les chemins par des points-virgules.Separate paths with semi-colons.

ExempleExample

La ligne de commande suivante définit le serveur de symboles Windows comme valeur de la variable d’environnement _NT_SYMBOL_PATH et C:\Symbols comme répertoire local.The following command line sets the _NT_SYMBOL_PATH environment variable to the Windows symbol server and the local directory to C:\Symbols.

set _NT_SYMBOL_PATH=srv*C:\symbols*http://msdl.microsoft.com/downloads/symbolsset _NT_SYMBOL_PATH=srv*C:\symbols*http://msdl.microsoft.com/downloads/symbols

La ligne de commande VSPerfReport suivante ajoute le répertoire C:\Projects\Symbols au chemin de recherche à l’aide de l’option /SymbolPath.The following VSPerfReport command line adds the C:\Projects\Symbols directory to the search path by using the /SymbolPath option.

VSPerfReport MyApp .exe /SymbolPath:C:\Projects\Symbols /summary:allVSPerfReport MyApp .exe /SymbolPath:C:\Projects\Symbols /summary:all