Como: Especifique locais de arquivo de símbolo na linha de comando

  • Artigo

Para exibir informações de símbolo, como nomes de função e números de linha, a ferramenta de linha de comando VSPerfReport requer acesso os arquivos de símbolos (. PDB) dos componentes com perfil e os arquivos de sistema do Windows. Arquivos de símbolo são criados quando um componente é compilado. Para obter mais informações, consulte VSPerfReport. VSPerfReport procura automaticamente os seguintes locais para arquivos de símbolo:

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

  • O caminho de local exato onde um componente foi compilado.

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

A Microsoft fornece os arquivos. PDB para muitos dos seus produtos on-line em um servidor de símbolos. Se o computador que você está usando para emissão de relatórios é conectado à Internet, VSPerfReport conecta-se ao servidor on-line de símbolo para consultar informações de símbolo e salvar os arquivos em um armazenamento local automaticamente.

Você pode especificar o local dos arquivos de símbolos e o armazenamento de servidor do Microsoft símbolo das seguintes maneiras:

  • Definir o _NT_SYMBOL_PATH variável de ambiente.

  • Adicionar o /SymbolPath opção para a linha de comando VSPerfReport.

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

ObservaçãoObservação

Se Visual Studio está instalado no computador local, um local para os arquivos de símbolos do Windows provavelmente foi especificado já. Para obter mais informações, consulte Como: Informações de referência do símbolo de Windows. Você deve configurar VSPerfReport para usar o local e o servidor conforme descrito posteriormente neste tópico.

Especificando os arquivos de símbolos do Windows

Para configurar o uso do servidor de símbolos do Windows

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

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

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

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

Especificando os arquivos de símbolos de componente

Arquivos de the.pdb dos componentes que você deseja o perfil em seus locais originais que estão armazenados nos componentes ou na pasta que contém o arquivo de dados de criação de perfil de procura de ferramentas de criação de perfil. Você pode especificar outros locais para pesquisa adicionando um ou mais caminhos para _NT_SYMBOL_PATH ou para o /SymbolPath opção. Caminhos separados com ponto e vírgula.

Exemplo

O linha de comando a seguir define o _NT_SYMBOL_PATH a variável de ambiente do Windows server e o diretório local para o símbolo C:\Symbols.

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

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

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