How to: Specify symbol file locations from the command line (Jak określić lokalizacje plików symboli z wiersza polecenia)

Aby wyświetlić informacje o symbolach, takie jak nazwy funkcji i numery wiersza, narzędzie wiersza polecenia VSPerfReport wymaga dostępu do symbolu (.pliki pdb) profilowane składniki i Windows plików systemowych. Pliki symboli są tworzone podczas kompilowania składnika. Aby uzyskać więcej informacji, zobacz VSPerfReport. VsPerfReport automatycznie wyszukuje pliki symboli w następujących lokalizacjach:

  • Ścieżki określone w opcji /SymbolPath lub _NT_SYMBOL_PATH zmiennej środowiskowej.

  • Dokładna ścieżka lokalna, w której skompilowano składnik.

  • Katalog zawierający dane profilowania (.vsp lub . vsps) Plik.

    Firma Microsoft udostępnia usługę . Pliki pdb dla wielu swoich produktów w trybie online na serwerze symboli. Jeśli komputer, który służy do raportowania, jest połączony z Internetem, vsPerfReport łączy się z serwerem symboli online, aby automatycznie wyszukiwania informacji o symbolach i zapisać pliki w magazynie lokalnym.

    Lokalizację plików symboli i magazyn serwera symboli firmy Microsoft można określić w następujący sposób:

  • Ustaw zmienną _NT_SYMBOL_PATH środowiskowej.

  • Dodaj opcję /SymbolPath do wiersza polecenia VSPerfReport.

    Można również użyć obu tych metod.

Uwaga

Jeśli program jest zainstalowany na komputerze lokalnym, lokalizacja plików symboli Windows została już Visual Studio określona. Aby uzyskać więcej informacji, zobacz How to: Reference Windows symbol information. Nadal należy skonfigurować vsPerfReport do używania lokalizacji i serwera, zgodnie z opisem w dalszej części tego tematu.

Określanie Windows plików symboli

Aby skonfigurować użycie Windows serwera symboli

  1. W razie potrzeby utwórz katalog do przechowywania plików symboli lokalnie.

  2. Użyj następującej składni, aby ustawić zmienną _NT_SYMBOL_PATH środowiskową lub opcję VSPerfReport /SymbolPath:

    srv*{LocalStore}*https://msdl.microsoft.com/download/symbols

    gdzie {LocalStore} jest ścieżką utworzonego katalogu lokalnego.

Określanie plików symboli składnika

narzędzia profilowania wyszukuje . pliki pdb składników, które mają być profilowane w oryginalnych lokalizacjach przechowywanych w tych składnikach lub w folderze zawierającym plik danych profilowania. Możesz określić inne lokalizacje do wyszukania, dodając co najmniej jedną ścieżkę do _NT_SYMBOL_PATH lub do opcji /SymbolPath. Oddziel ścieżki średnikami.

Przykład

Poniższy wiersz polecenia ustawia zmienną _NT_SYMBOL_PATH na serwer symboli Windows, a katalog lokalny na C:\Symbols.

 set  _NT_SYMBOL_PATH=srv*C:\symbols*https://msdl.microsoft.com/download/symbols

Następujący wiersz polecenia VSPerfReport dodaje katalog C:\Projects\Symbols do ścieżki wyszukiwania przy użyciu opcji /SymbolPath.

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