Zadání symbolu (.pdb) a zdrojových souborů v ladicím programu sady Visual Studio (C#, C++, Visual Basic, F#)

Soubory programové databáze (.pdb), také označované jako soubory symbolů, mapují identifikátory a příkazy ve zdrojovém kódu vašeho projektu na odpovídající identifikátory a pokyny v kompilovaných aplikacích. Tyto soubory mapování propojují debugger k vašemu zdrojovému kódu, což umožňuje ladění.

Když sestavujete projekt z integrovaného vývojového prostředí Visual Studio pomocí standardní konfigurace sestavení pro ladění, kompilátor vytvoří příslušné soubory symbolů. Tento článek popisuje, jak spravovat soubory symbolů v integrovaném vývojovém prostředí, například:

• Konfigurace umístění souborů symbolů
• Načíst symboly při ladění
• Možnosti kompilátoru pro symboly

Podrobné vysvětlení souborů symbolů najdete v tématu Vysvětlení souborů symbolů a nastavení symbolů sady Visual Studio.

Jak fungují soubory symbolů

Soubor .pdb obsahuje informace o ladění a stavu projektu, které umožňují přírůstkové propojení konfigurace ladění vaší aplikace. Ladicí program sady Visual Studio používá soubory .pdb k určení dvou klíčových informací při ladění:

• Název zdrojového souboru a číslo řádku, které se zobrazí v integrovaném vývojovém prostředí sady Visual Studio
• Kde nastavit bod přerušení v aplikaci

Soubory symbolů také zobrazují umístění zdrojových souborů a volitelně i server, ze které je má načíst.

Ladicí program načte pouze soubory .pdb, které přesně odpovídají souborům .pdb vytvořeným při sestavování aplikace (tj. původní soubory .pdb nebo jejich kopie). Tato přesná duplikace je nezbytná, protože rozložení aplikací se může změnit i v případě, že se samotný kód nezmění. Další informace najdete v tématu Proč Visual Studio vyžaduje soubory symbolů ladicího programu, aby přesně odpovídaly binárním souborům, se kterými byly vytvořeny?

Spropitné

Pokud chcete ladit kód, který není součástí zdrojového kódu vašeho projektu, například kód Windows nebo kód třetí strany, které váš projekt volá, musíte zadat umístění souborů .pdb externího kódu (a případně zdrojových souborů), které musí přesně odpovídat sestavení v aplikaci.

Kde ladicí program hledá symboly

Při ladění projektu v integrovaném vývojovém prostředí sady Visual Studio ladicí program automaticky načte soubory symbolů, které dokáže ve výchozím nastavení najít.

Poznámka

Při ladění spravovaného kódu na vzdáleném zařízení musí být všechny soubory symbolů umístěny buď na místním počítači, nebo v umístění zadané v možnostech ladicího programu.

Ladicí program vyhledá soubory symbolů v následujících umístěních v zadaném pořadí:

1. Složka projektu.

2. Umístění zadané v souboru DLL nebo spustitelného souboru (.exe).

   Ve výchozím nastavení, pokud jste vytvořili knihovnu DLL nebo soubor .exe v počítači, linker umístí úplnou cestu a název přidruženého souboru .pdb do knihovny DLL nebo souboru .exe. Ladicí program zkontroluje, zda soubor symbolů existuje na tomto místě.

3. Stejný adresář jako knihovna DLL nebo soubor .exe.

4. Všechna umístění zadaná v možnostech ladicího programu pro soubory symbolů. Pokud chcete přidat a povolit umístění symbolů, přečtěte si téma Konfigurace umístění symbolů a možnosti načítání.

   • Libovolná složka mezipaměti místních symbolů.

   • Zadané síťové, internetové nebo místní servery a umístění symbolů, například servery symbolů Microsoft, pokud byly vybrány. Visual Studio může stahovat soubory ladicích symbolů ze serverů, které implementují protokol symsrv. Visual Studio Team Foundation Server a nástroje pro ladění pro Windows jsou dva nástroje, které mohou používat servery symbolů.

     Mezi servery symbolů, které můžete použít, patří:

     Veřejné servery symbolů společnosti Microsoft: Pro ladění pádu aplikace, ke kterému dochází při volání systémové DLL nebo knihovny třetí strany, často potřebujete odpovídající systémové soubory .pdb. Systémové soubory .pdb obsahují symboly pro knihovny DLL systému Windows, soubory .exe a ovladače zařízení. Symboly pro operační systémy Windows, MDAC, IIS, ISA a .NET můžete získat z veřejných serverů symbolů Microsoftu.

     servery symbolů v interní síti nebo na místním počítači: Váš tým nebo společnost může vytvářet servery symbolů pro vlastní produkty a jako mezipaměť pro symboly z externích zdrojů. Server symbolů můžete mít na vlastním počítači.

     servery symbolů třetích stran: Externí poskytovatelé aplikací a knihoven systému Windows můžou poskytnout přístup k serveru symbolů na internetu.

Varování

Pokud používáte jiný server symbolů než veřejné servery symbolů Microsoftu, ujistěte se, že server symbolů a jeho cesta jsou důvěryhodné. Protože soubory symbolů můžou obsahovat libovolný spustitelný kód, můžete být vystaveni bezpečnostním hrozbám.

Konfigurace umístění souborů symbolů a možností načítání

Ladicí program ve výchozím nastavení hledá symboly v různých umístěních. Další informace naleznete v tématu Kde ladicí program hledá symboly.

V nabídce Možnosti nástrojů (nebo Ladění) > můžete získat přístup kmožnostem symbolůladění>:

• Zadejte a vyberte cesty hledání pro soubory symbolů.
• Zadejte servery symbolů pro součásti Microsoftu, Windows nebo třetích stran.
• Zadejte moduly, pro které chcete nebo nechcete, aby ladicí program automaticky načítal symboly.
• Při aktivním ladění změňte tato nastavení. Podívejte se na Načtení symbolů při ladění.

Určení umístění symbolů a možností načítání:

1. Otevřete podokno Nástroje (nebo Ladění) >Možnosti, a rozbalte část Všechna Nastavení>Ladění>Obecné>Symboly>Umístění Hledání.

2. V pravém podokně zaškrtněte políčko pro každý požadovaný server: Servery symbolů Microsoftu, NuGet.org Server symbolů atd.

3. Nové umístění serveru symbolů přidáte tak, že v panelu nástrojů u skupinového rámečku Umístění souborů symbolů (.pdb) vyberete + Přidat.

   Do textového pole zadejte adresu URL (http), sdílenou síť nebo místní cestu k serveru symbolů nebo umístění symbolů. Doplňování výroků vám pomůže najít správný formát.

   

   Poznámka

   Prohledá se jenom zadaná složka. Je nutné přidat položky pro všechny podsložky, které chcete prohledávat.

   Zaškrtněte políčko Povoleno a pak vyberte Uložit.

4. Přidejte nové umístění serveru symbolů Azure DevOps výběrem odkazu Nové umístění serveru symbolů Azure DevOps.

   V dialogovém okně Připojit k serveru symbolů Azure DevOps vyberte dostupný server symbolů a pak vyberte Připojit.

   

   Další informace najdete v tématu Přidání serveru symbolů Azure Artifacts.

   • Pokud chcete změnit pořadí načítání pro umístění symbolů, použijte klávesy Ctrl + Nahoru a Ctrl + Dolů nebo vyberte Přesunout nahoru a Dolů.
   • Pokud chcete upravit adresu URL nebo cestu, poklikejte na položku nebo ji zvýrazněte a vyberte Upravit.
   • Pokud chcete položku odebrat, zvýrazněte ji a vyberte Odebrat.

5. (Volitelné) Zvýšení výkonu načítání symbolů zadáním cesty k místní složce pro zkopírované symboly

   Pro možnost Ukládání symbolů do mezipaměti v tomto adresáři zadejte místní cestu ke složce, do které mohou servery symbolů kopírovat symboly.

   Poznámka

   • Neumisťujte místní mezipaměť symbolů do chráněné složky, jako je C:\Windows nebo podsložka. Místo toho použijte složku pro čtení i zápis.

   • Pokud je nastavena proměnná prostředí _NT_SYMBOL_PATH, hodnota přepíše hodnotu 'Ukládat symboly do tohoto adresáře'.

6. Zadejte moduly, které má ladicí program načíst z umístění souboru symbolů (.pdb) při spuštění.

   1. Přejděte do části Všechna nastavení>ladění>obecné>symboly>Hledání a načtení.

   2. Pomocí rozevíracího seznamu nastavte hodnotu možnosti Automatické vyhledávání symbolů :

      • Automaticky zvolte, jaké symboly modulů se mají hledat (doporučeno): Povolit Visual Studio rozhodnout, jaké symboly se mají hledat a načíst. Ve výchozím nastavení sada Visual Studio automaticky načte symboly vytvořené otevřeným řešením a načte všechny další symboly potřebné k provádění běžných operací ladění. Tato možnost snižuje počet souborů, které je potřeba vyhledat a načíst sadou Visual Studio, což zlepšuje výkon ladicího programu. Další symboly můžete vynutit načtení vytvořením seznamu zahrnutých modulů.

        

      • Vyhledávat všechny symboly modulu, pokud nejsou výslovně vyloučeny: Vynutit, aby Visual Studio načetlo všechny symboly v procesu ladění. Tato možnost se nedoporučuje, protože může zpomalit vaši zkušenost s laděním. Visual Studio můžete vynutit ignorování určitých symbolů vytvořením seznamu vyloučených modulů.

        

Zadání filtrů modulů

Obě možnosti Automaticky zvolit ... a Hledat všechny ... umožňují řídit, jaké symboly se při ladění hledají.

Pro možnost Automaticky zvolit, které symboly modulu se mají vyhledat , zadejte vyhledávací seznam vytvořením seznamu zahrnutých modulů .

1. Vyberte + Přidat na panelu nástrojů seznamu.

2. V dialogovém okně Přidat položku zadejte název modulu, zaškrtněte políčko Povoleno a pak vyberte Uložit.

3. Podle potřeby přidejte do seznamu další položky.

Filtry modulů podporují jednoduché porovnávání zástupných znaků. * Hvězdička odpovídá libovolné skupině znaků. Například *myproduct* odpovídá souborům, jako jsou myproduct.utilities.dll a entrypoint.myproduct.exe, mimo jiné.

Můžete nakonfigurovat další možnosti pro přizpůsobení prostředí:

• Vždy načtěte symboly umístěné vedle modulů: Visual Studio načte soubory .pdb uložené v systému souborů s odpovídajícími soubory .dll nebo .exe. Tento přístup může být užitečný, například při pokusu o ladění nasazené webové aplikace.

• Automaticky načíst další symboly v případě potřeby: Visual Studio hledá symboly pro provádění běžných ladicích akcí, jako je krokování, i když modul, na který krokujete, není v projektu nebo ve filtru modulů. Způsob, jakým je vyhledávání určeno, může být ovlivněno nastavením jen mého kódu .

Pro hledání všech symbolů modulu, pokud není vyloučena možnost, zadejte vyhledávací seznam vytvořením seznamu vyloučených modulů .

1. Vyberte + Přidat na panelu nástrojů seznamu.

2. V dialogovém okně Přidat položku zadejte název modulu, zaškrtněte políčko Povoleno a pak vyberte Uložit.

3. Podle potřeby přidejte do seznamu další položky.

Další možnosti symbolů pro ladění

V nabídce Nástroje (nebo Ladění) >Možnosti můžete vybrat další možnosti symbolu ladění.

Následující nastavení jsou k dispozici v částiVšechna nastavení>ladění>obecné.

• Načtení exportů DLL (pouze nativní): Načte exportní tabulky knihovny DLL pro C/C++. Podrobnosti viz exportních tabulek DLL. Čtení informací o exportu knihovny DLL zahrnuje určité náklady, takže načítání tabulek exportu je výchozí vypnuté. Můžete také použít dumpbin /exports v příkazovém řádku sestavení C/C++.

• Povolte ladění na úrovni adresy a zobrazení zpětného překladu, pokud zdroj není k dispozici: Vždy zobrazí zpětný překlad, když se nenašly zdrojové soubory nebo soubory symbolů.

• Povolení podpory zdrojového serveru: Používá zdrojový server k ladění aplikace, pokud na místním počítači neexistuje žádný zdrojový kód nebo soubor .pdb neodpovídá zdrojovému kódu. Zdrojový server přijímá požadavky na soubory a vrací skutečné soubory ze správy zdrojového kódu. Zdrojový server běží pomocí knihovny DLL s názvem srcsrv.dll ke čtení souboru .pdb aplikace. Soubor .pdb obsahuje ukazatele na úložiště zdrojového kódu a příkazy používané k načtení zdrojového kódu z úložiště.

  Příkazy, které srcsrv.dll mohou spouštět ze souboru .pdb aplikace, můžete omezit tak, že v souboru s názvem srcsrv.inizobrazí povolené příkazy. Umístěte soubor srcsrv.ini do stejné složky jako srcsrv.dll a devenv.exe.

  Důležitý

  Do souboru .pdb aplikace lze vložit libovolné příkazy, proto nezapomeňte vložit jenom příkazy, které chcete spustit, do souboru srcsrv.ini. Při každém pokusu o spuštění příkazu, který není v souborusrcsvr.ini , se aktivuje potvrzovací dialogové okno. Další informace naleznete v tématu výstraha zabezpečení: Ladicí program musí spustit nedůvěryhodný příkaz.

  U parametrů příkazu se neprovádí žádné ověření, proto buďte opatrní s důvěryhodnými příkazy. Pokud jste například ve svémsrcsrv.iniuvedli cmd.exe, může škodlivý uživatel zadat parametry cmd.exe, které můžou zneškodnit.

  Vyberte požadované podpůrné předvolby. Mějte na paměti, že možnost Povolit zdrojovému serveru pro sestavení s částečnou důvěryhodností (pouze spravovaná) a vždy spouštět nedůvěryhodné příkazy zdrojového serveru bez zobrazení výzvy můžou zvýšit riziko ohrožení zabezpečení.

Možnosti symbolů kompilátoru

Když sestavíte projekt v integrovaném vývojovém prostředí Visual Studio se standardní konfigurací sestavení Ladění, vytvoří kompilátory jazyka C++ a spravované kompilátory příslušné soubory symbolů pro váš kód. V kódu můžete také nastavit možnosti kompilátoru.

Pokud chcete nastavit možnosti kompilátoru pro konfigurace sestavení v sadě Visual Studio, viz téma Nastavení konfigurací ladění a verzí.

Možnosti .NET

Sestavte pomocí /debug a vytvořte soubor .pdb. Aplikace můžete vytvářet pomocí /debug:full nebo /debug:pdbonly. Sestavení pomocí /debug:full generuje laditelný kód. Sestavení pomocí /debug:pdbonly generuje soubory .pdb, ale negeneruje DebuggableAttribute, který by kompilátoru JIT sdělil, že jsou k dispozici informace o ladění. Pokud chcete generovat soubory .pdb pro sestavení vydané verze, které nechcete ladit, použijte /debug:pdbonly. Další informace najdete v tématu /debug (možnosti kompilátoru jazyka C#) nebo /debug (Visual Basic).

Možnosti jazyka C/C++

• <x>.pdb a <>.pdb soubory

  Při sestavování pomocí /ZI nebo /Zise vytvoří soubor .pdb pro C/C++. V jazyce Visual C++ /Fd možnost pojmenuje .pdb soubor, který kompilátor vytvoří. Při vytváření projektu v sadě Visual Studio pomocí integrovaného vývojového prostředí je možnost /Fd nastavena tak, aby se vytvořil soubor .pdb s názvem <projektu>.pdb.

  Pokud sestavíte aplikaci C/C++ pomocí souboru pravidel a zadáte /ZI nebo /Zi bez použití /Fd zadat název souboru, kompilátor vytvoří dva soubory .pdb:

  • VC<x>.pdb, kde <x> představuje verzi kompilátoru Microsoft C++, například VC11.pdb

    Soubor VC<x>.pdb ukládá všechny informace o ladění pro jednotlivé soubory objektů a nachází se ve stejném adresáři jako soubor pravidel projektu. Pokaždé, když vytvoří soubor objektu, kompilátor C/C++ sloučí ladicí informace do VC<x>.pdb. Takže i v případě, že každý zdrojový soubor obsahuje společné soubory hlaviček, jako je <windows.h>, jsou definice typů z těchto hlaviček uloženy pouze jednou, nikoli v každém souboru objektu. Vložené informace obsahují informace o typu, ale neobsahují informace o symbolech, jako jsou definice funkce.

  • <projekt>.pdb

    Soubor <projektu>.pdb ukládá všechny informace o ladění pro .exe soubor projektu a nachází se v podadresáři \debug. Soubor <project>.pdb obsahuje úplné informace k ladění, včetně prototypů funkcí, nejen informace o typu, které se nacházejí v VC<x>.pdb.

  Jak VC<x>.pdb, tak <projekt>.pdb soubory umožňují přírůstkové aktualizace. Linker také vloží cestu k souborům .pdb do .exe nebo .dll souboru, který vytvoří.

• Tabulka exportu DLL

  Pomocí dumpbin /exports zobrazíte symboly dostupné v tabulce exportu knihovny DLL. Symbolické informace z tabulek exportu knihovny DLL mohou být užitečné pro práci se zprávami Systému Windows, procedurami Systému Windows (WindowProcs), objekty COM, zařazováním nebo jakoukoli knihovnou DLL, pro kterou nemáte symboly. Symboly jsou k dispozici pro libovolnou 32bitovou systémovou knihovnu DLL. Volání jsou uvedena v pořadí volání, přičemž aktuální funkce (nejvíce vnořená) je v horní části.

  Čtením výstupu dumpbin /exports můžete vidět přesné názvy funkcí, včetně nealfanumerických znaků. Zobrazení přesných názvů funkcí je užitečné pro nastavení zarážky u funkce, protože názvy funkcí mohou být jinde v ladicím programu zkráceny. Další informace najdete v tématu dumpbin /exports.

Webové aplikace

Nastavte soubor web.config aplikace ASP.NET na režim ladění. Režim ladění způsobí, že ASP.NET generuje symboly pro dynamicky generované soubory a umožňuje ladicímu programu připojit se k aplikaci ASP.NET. Visual Studio to nastaví automaticky, když začnete ladit, pokud jste projekt vytvořili ze šablony webových projektů.

Načtení symbolů při ladění

K načtení symbolů nebo změně možností symbolů při ladění můžete použít moduly ,, zásobník volání ,, okno Lokální ,, Automatické ,nebo jakékoli okno Sledování ,. Další informace najdete v tématu Seznámení s tím, jak se ladicí program připojuje k aplikaci.

Práce se symboly v okně Moduly

Během ladění se v okně Moduly zobrazí moduly kódu, které ladicí program považuje za uživatelský kód, nebo můj kód, a stav jejich načítání symbolů. V okně Moduly můžete také monitorovat stav načítání symbolů, načíst symboly a změnit možnosti symbolů.

Monitorování nebo změna umístění symbolů nebo možností při ladění:

1. Pokud chcete otevřít okno Moduly, při ladění vyberte Ladění>>Moduly (nebo stiskněte Ctrl + Alt + U).

2. V okně Moduly klikněte pravým tlačítkem na záhlaví Stav symbolu, Soubor symbolů nebo na libovolný modul.

3. V místní nabídce vyberte jednu z následujících možností:

   Možnost	Popis
   Načíst symboly	Zobrazuje se pro moduly s přeskočenými, nenalezenými nebo nenahranými symboly. Pokusí se načíst symboly z umístění zadaných v podokně Nástroje>Možnosti v části Všechna nastavení>ladění> pod Hledání a načítání nebo >. Pokud se soubor symbolů nenajde nebo nenačte, spustí Průzkumníka souborů , abyste mohli zadat nové umístění pro vyhledávání.
   Informace o načtení symbolů	Zobrazuje umístění načteného souboru symbolů nebo umístění, která byla prohledána, pokud ladicí program nemůže soubor najít.
   nastavení symbolů	Otevře podokno Možnosti nástrojů> v částiVšechna> ladění>>, kde můžete upravit a přidat umístění symbolů.
   Vždy automaticky načíst	Přidá vybraný soubor symbolů do seznamu souborů, které jsou automaticky načteny ladicím programem.
   Dekompilovat zdroj do souboru symbolů	Pro kód .NET můžete zvolit tuto možnost a poté postupovat podle pokynů v části Generování a vkládání zdrojů pro sestavení.

Použití stránek bez načtených symbolů nebo zdrojů

Ladicí program může přerušit běh kódu, ke kterému nejsou k dispozici symbolové nebo zdrojové soubory:

• Ponořte se do kódu.
• Rozdělte kód ze zarážky nebo výjimky.
• Přepněte na jiné vlákno.
• Změňte rámec zásobníku poklepáním na rámec v okně Zásobník volání.

V takovém případě ladicí program zobrazí stránky Žádné symboly nebyly načteny nebo Žádný zdroj nebyl načten, které vám pomohou najít a načíst potřebné symboly nebo zdroj.

Chcete-li použít stránku dokumentu Žádné symboly nebyly načteny k tomu, abyste pomohli nalézt a načíst chybějící symboly:

• Pokud chcete změnit cestu hledání, vyberte nevybranou cestu nebo vyberte Nová cesta nebo Nová cesta VSTS a zadejte nebo vyberte novou cestu. Vyberte Načíst pro opětovné prohledání cest a načtení souboru symbolů, pokud je nalezen.

• Chcete-li přepsat všechny možnosti symbolů a zopakovat cesty hledání, vyberte Procházet, a vyhledejte <název spustitelného souboru>. Soubor symbolu se načte, pokud je nalezen, nebo se otevře Průzkumník souborů , abyste mohli soubor symbolů vybrat ručně.

• Chcete-li otevřít stránku nastavení symbolů pro konfiguraci chování, vyberte Změnit nastavení symbolů (nebo otevřete Nástroje>Možnosti a přejděte do části Všechna nastavení>ladění>symboly>Hledání a načtení nebo Umístění hledání).

• (Upřesnit) Chcete-li jednorázově zobrazit demontáž v novém okně, vyberte prohlížení demontáže, nebo zvolte dialogové okno Možnosti pro nastavení, aby se možnost vždy zobrazovala, když nejsou nalezeny zdrojové nebo symbolické soubory. Další informace naleznete v tématu Zobrazení disassemblovaného kódu.

• Chcete-li zobrazit hledaná umístění a výsledek, rozbalte Informace o načítání symbolů.

• V případě kódu jazyka C# můžete také dekompilovat zdrojový kód ze stránek Nenačteny žádné symboly nebo Nenačten žádný zdroj.

Pokud ladicí program najde .pdb soubor po spuštění jedné z možností a může načíst zdrojový soubor pomocí informací v souboru .pdb, zobrazí zdroj. V opačném případě se zobrazí stránka Zdroj není načten, která popisuje problém s odkazy na akce, které mohou problém vyřešit.

Přidání cest hledání zdrojových souborů do řešení:

Můžete určit umístění, ve kterých ladicí program hledá zdrojové soubory, a vyloučit konkrétní soubory z hledání.

1. Vyberte řešení v průzkumníku řešení , pak vyberte ikonu vlastností , stiskněte kombinaci kláves Alt+Enter, nebo klikněte pravým tlačítkem myši a vyberte možnost vlastnosti.

2. Vyberte zdrojové soubory pro ladění.

   

3. V části Adresáře obsahující zdrojový kódzadejte nebo vyberte umístění zdrojového kódu, která chcete vyhledat. Pomocí ikony Nový řádek můžete přidat další umístění, ikony šipek nahoru a dolů změnit jejich pořadí, nebo ikony X je odstranit.

   Poznámka

   Ladicí program prohledá pouze zadaný adresář. Je nutné přidat položky pro všechny podadresáře, které chcete hledat.

4. V části Nehledejte tyto zdrojové soubory, zadejte názvy zdrojových souborů, které chcete vyloučit z hledání.

5. Vyberte OK nebo Použít.

Související obsah

• Pochopit soubory symbolů a nastavení symbolů sady Visual Studio