Compartilhar via


Como especificar locais de arquivo de símbolo a partir da linha de comando

Para exibir informações do símbolo como nomes de função e números de linha, a ferramenta de linha de comando VSPerfReport requer acesso aos arquivos do símbolo (.pdb) dos componentes analisados e dos arquivos do sistema do windows.Os arquivos do símbolo são criados quando um componente é criado.Para obter mais informações, consulte VSPerfReport.VSPerfReport pesquisa automaticamente os seguintes locais pelos arquivos do símbolo:

  • Caminhos especificados na opção de /SymbolPath ou na variável de ambiente de _NT_SYMBOL_PATH .

  • O caminho local exato em que um componente foi compilado.

  • O diretório que contém o arquivo de dados de perfil (.vsp ou .vsps).

O Microsoft fornece os arquivos .pdb para muitos dos produtos online em um servidor de símbolo.Se o computador que você está usando de relatório estiver conectado à Internet, VSPerfReport se conecta ao servidor online do símbolo para procurar informações de símbolo e salvar automaticamente os arquivos a um repositório local.

Você pode especificar o local dos arquivos do símbolo e do repositório de servidores do símbolo da Microsoft das seguintes maneiras:

  • Defina a variável de ambiente de _NT_SYMBOL_PATH .

  • Adicione a opção de /SymbolPath à linha de comando de VSPerfReport.

Você também pode usar ambos os métodos.

ObservaçãoObservação

Se Visual Studio é instalado no computador local, um local para os arquivos do símbolo windows tiver sido especificado provavelmente já.Para obter mais informações, consulte Como fazer referência a informações de símbolo do Windows.Você ainda deverá configurar VSPerfReport para usar o local e o servidor como descrito mais adiante neste tópico.

Especificando arquivos do símbolo do windows

Para configurar o uso do servidor do símbolo do windows

  1. Se necessário, crie um diretório local para armazenar os arquivos de símbolo.

  2. Use a sintaxe a seguir para definir a variável de ambiente de _NT_SYMBOL_PATH ou a opção de VSPerfReport /SymbolPath:

    srv*LocalStore*http://msdl.microsoft.com/downloads/symbols

    onde LocalStore é o caminho do diretório local que você criou.

Especificando arquivos componentes do símbolo

Pesquisas de Ferramentas de Criação de Perfil para arquivos de the.pdb componentes que você deseja analisar seus locais originais que são armazenados nos componentes ou na pasta que contém o arquivo de dados de perfil.Você pode especificar outros locais para pesquisar adicionar um ou mais caminhos para _NT_SYMBOL_PATH ou à opção de /SymbolPath .Caminhos separados por ponto-e-vírgulas.

Exemplo

A linha de comando a seguir define a variável de ambiente de _NT_SYMBOL_PATH ao servidor do símbolo do windows e o diretório local a C:\Symbols.

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

A seguinte linha de comando de VSPerfReport adiciona o diretório de C:\Projects\Symbols ao caminho de pesquisa usando a opção de /SymbolPath .

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