Použití zarážek v ladicím Visual Studio ladění

Zarážky jsou jednou z nejdůležitějších technik ladění v sadě nástrojů pro vývojáře. Zarážky nastavíte všude, kde chcete pozastavit provádění ladicího programu. Můžete například chtít zobrazit stav proměnných kódu nebo se podívat na zásobník volání na určité zarážce. Pokud se pokoušíte vyřešit upozornění nebo problém při používání zarážek, podívejte se na téma Řešení potíží se zarážkami v Visual Studio ladicím programu.

Nastavení zarážek ve zdrojovém kódu

Zarážku můžete nastavit na libovolném řádku spustitelného kódu. Například v následujícím kódu jazyka C# můžete nastavit zarážku na řádku kódu s přiřazením proměnné ( ), smyčkou nebo libovolným kódem uvnitř int testInt = 1 for for smyčky. Nelze nastavit zarážku u podpisů metod, deklarací pro obor názvů nebo třídu nebo deklarací proměnných, pokud neexistuje žádné přiřazení a žádné metody getter/setter.

Pokud chcete nastavit zarážku ve zdrojovém kódu, klikněte na levý okraj vedle řádku kódu. Můžete také vybrat řádek a stisknout F9, vybrat Ladit Přepnout zarážku nebo kliknout pravým tlačítkem a > vybrat Zarážka > Vložit zarážku. Zarážka se na levém okraji zobrazí jako červená tečka.

U většiny jazyků, včetně jazyka C#, jsou zarážky a aktuální řádky spuštění automaticky zvýrazněny. U kódu jazyka C++ můžete zapnout zvýraznění zarážek a aktuálních řádků tak, že vyberete Nástroje (nebo Ladit) > Možnosti Ladění Zvýraznit celý zdrojový řádek pro zarážky a aktuální příkaz > > (pouze C++).

Při ladění se provádění pozastaví na zarážce před provedením kódu na tomto řádku. Symbol zarážky zobrazuje žlutou šipku.

Na zarážce v následujícím příkladu je hodnota stále testInt 1. Hodnota se proto od inicializace proměnné (nastavená na hodnotu 1) nezměnila, protože příkaz žlutá ještě nebyl proveden.

Když se ladicí program zastaví na zarážce, můžete se podívat na aktuální stav aplikace, včetně hodnot proměnných a zásobníku volání.

Tady je několik obecných pokynů pro práci se zarážkami.

• Zarážka je přepínač. Můžete na něj kliknout, stisknout klávesu F9 nebo ji odstranit nebo znovu vložit pomocí přepínače > ladění zarážky.

• Pokud chcete zarážku zakázat bez odstranění, najeďte myší na zarážku nebo na ní klikněte pravým tlačítkem myši a vyberte Zakázat zarážku. Zakázané zarážky se zobrazují jako prázdné tečky na levém okraji nebo v okně Breakpoints (Zarážky). Pokud chcete zarážku znovu povolit, najeďte myší na zarážku nebo na ní klikněte pravým tlačítkem a vyberte Povolit zarážku.

• Nastavte podmínky a akce, přidejte a upravte popisky nebo exportujte zarážku tak, že na něj kliknete pravým tlačítkem a vyberete příslušný příkaz nebo na něj najedete myší a vyberete ikonu Nastavení.

Akce zarážek a tracepointy

Tracepoint je zarážka, která vytiskne zprávu do okna Výstup. Trasovací bod může v programovacím jazyce fungovat jako dočasný příkaz trasování a nepozastaví provádění kódu. Trasovací bod vytvoříte nastavením speciální akce v okně Nastavení zarážky. Podrobné pokyny najdete v tématu Použití trasovacích bodů v Visual Studio ladicím programu.

Podmínky zarážek

Nastavením podmínek můžete řídit, kdy a kde se zarážka provádí. Podmínka může být libovolný platný výraz, který ladicí program rozpozná. Další informace o platných výrazech najdete v tématu Výrazy v ladicím programu.

Nastavení podmínky zarážky:

1. Klikněte pravým tlačítkem na symbol zarážky a vyberte Podmínky (nebo stiskněte Alt + F9, C). Nebo najeďte myší na symbol zarážky, vyberte ikonu Nastavení a pak vyberte Podmínky v okně Nastavení zarážky.

Podmínky můžete nastavit také v okně Zarážky tak, že kliknete pravým tlačítkem na zarážku, vyberete Nastavení a pak vyberete Podmínky.

2. V rozevíracím seznamu vyberte Podmíněný výraz, Počet přístupů nebo Filtr a nastavte hodnotu odpovídajícím způsobem.

3. Stisknutím Klávesy Ctrl Enter zavřete okno zarážky + Nastavení stisknutím klávesy . Nebo v okně Breakpoints (Zarážky) zavřete dialogové okno výběrem OK.

Zarážky s nastavenými podmínkami se zobrazí se symbolem ve zdrojovém kódu a + v oknech Zarážek.

Vytvoření podmíněného výrazu

Když vyberete Podmíněný výraz, můžete si vybrat mezi dvěma podmínkami: Is true (Pravda) nebo When changed (Při změně). Zvolte Is true (Je true), pokud chcete výraz po jeho vyhoření přerušit, nebo když se změní hodnota výrazu, aby se po změně hodnoty přerušil.

V následujícím příkladu je zarážka uvedená pouze v případě, že je testInt hodnota 4:

V následujícím příkladu je zarážka uvedená pouze v případě, že se hodnota testInt změní:

Pokud nastavíte podmínku zarážky s neplatnou syntaxí, zobrazí se zpráva upozornění. Pokud zadáte podmínku zarážky s platnou syntaxí, ale neplatnou sémantikou, zobrazí se při prvním použití zarážky zpráva upozornění. V obou případech se ladicí program při použití neplatné zarážky přeruší. Zarážka se přeskočí jenom v případě, že je podmínka platná a vyhodnotí se jako false .

Použití ID objektů v podmíněných výrazech (pouze C# a F#)

Existují případy, kdy chcete sledovat chování konkrétního objektu. Můžete například chtít zjistit, proč byl objekt vložen do kolekce více než jednou. V jazyce C# a F# můžete vytvořit ID objektů pro konkrétní instance odkazových typů a použít je v podmínkách zarážky. ID objektu je generováno ladicími službami modulu CLR (Common Language Runtime) a přidruženo k objektu .

Vytvoření ID objektu:

1. Po vytvoření objektu nastavte zarážku v kódu na nějaké místo.

2. Spusťte ladění a když se provádění na zarážce pozastaví, vyberte Ladit > Windows > Místní hodnoty (nebo stiskněte Ctrl + Alt + V, L) a otevřete okno Místní hodnoty.

   Vyhledejte konkrétní instanci objektu v okně Místní hodnoty, klikněte na něj pravým tlačítkem a vyberte Vytvořit ID objektu.

   V okně Místní hodnoty by se mělo zobrazit plus $ číslo. Toto je ID objektu.

3. Do bodu, který chcete prozkoumat, přidejte novou zarážku. Například když má být objekt přidán do kolekce. Klikněte pravým tlačítkem na zarážku a vyberte Podmínky.

4. V poli Podmíněný výraz použijte ID objektu. Pokud je proměnná například objekt, který se má přidat do kolekce, vyberte Je true a zadejte item item == $ <n>, kde je číslo ID <n> objektu.

   Provádění se přeruší v okamžiku, kdy má být tento objekt přidán do kolekce.

   Pokud chcete odstranit ID objektu, klikněte pravým tlačítkem na proměnnou v okně Místní hodnoty a vyberte Odstranit ID objektu.

Nastavení podmínky počtu přístupů

Pokud máte podezření, že se smyčka ve vašem kódu po určitém počtu iterací začne chovat špatně, můžete nastavit zarážku tak, aby po tomto počtu přístupů zastavila provádění, místo abyste k dosažení této iterace museli opakovaně stisknout klávesu F5.

V části Podmínky v okně Nastavení zarážky vyberte Počet přístupů a pak zadejte počet iterací. V následujícím příkladu je zarážka nastavená tak, aby při každé druhé iteraci narazila na :

Nastavení podmínky filtru

Zarážku můžete omezit tak, aby se s rušilo jenom na zadaných zařízeních nebo v určených procesech a vláknech.

V části Podmínky v okně Nastavení vyberte Filtr a pak zadejte jeden nebo více následujících výrazů:

• MachineName = "name"
• ProcessId = hodnota
• ProcessName = "name"
• ThreadId = hodnota
• ThreadName = "name"

Řetězcové hodnoty uzavřete do dvojitých uvozovek. Klauzule můžete kombinovat pomocí & (AND), || (OR), ! (NOT) a závorek.

Nastavení zarážek funkcí

Při volání funkce můžete provádění přerušit. To je užitečné například v případě, že znáte název funkce, ale ne její umístění. Je také užitečné, pokud máte funkce se stejným názvem a chcete je rozdělit na všechny (například přetížené funkce nebo funkce v různých projektech).

Nastavení zarážky funkce:

1. Vyberte možnost ladit novou zarážku funkce zarážky > > nebo stiskněte klávesy CTRL + K, B.

   V okně zarážky můžete také vybrat novou zarážku funkce .

2. V dialogovém okně Nová zarážka funkce zadejte do pole název funkce název funkce.

   Zúžení specifikace funkce:

   • Použijte plně kvalifikovaný název funkce.

     Případě Namespace1.ClassX.MethodA()

   • Přidejte typy parametrů přetížené funkce.

     Případě MethodA(int, string)

   • K určení modulu použijte symbol '! '.

     Příklad: App1.dll!MethodA

   • Použijte operátor kontextu v nativním jazyce C++.

     {function, , [module]} [+<line offset from start of method>]

     Příklad: {MethodA, , App1.dll}+2

3. V rozevíracím seznamu jazyk vyberte jazyk funkce.

4. Vyberte OK.

Nastavení zarážky funkce pomocí adresy paměti (pouze nativní C++)

Můžete použít adresu objektu pro nastavení zarážky funkce pro metodu volanou určitou instancí třídy. Například vzhledem k adresovatelné objektu typu my_class můžete nastavit zarážku funkce na my_method metodu, kterou instance volá.

1. Nastavte zarážku někam po vytvoření instance třídy.

2. Vyhledejte adresu instance (například 0xcccccccc ).

3. Vyberte možnost ladit novou zarážku funkce zarážky > > nebo stiskněte klávesy CTRL + K, B.

4. Do pole název funkce přidejte následující a vyberte jazyk C++ .

   ((my_class *) 0xcccccccc)->my_method
   

Nastavení zarážek s daty (jenom nativní C++)

Datové zarážky přeruší provádění, když se změní hodnota uložená v zadané adrese paměti. Pokud je hodnota čtena, ale nemění se, provádění není přerušeno.

Nastavení datové zarážky:

1. V projektu C++ spusťte ladění a počkejte na dosažení zarážky. V nabídce ladění vyberte možnost Nová zarážka dat zarážky > .

   Můžete také vybrat možnost Nová > zarážka dat v okně zarážky nebo kliknout pravým tlačítkem myši na položku v okně Automatické hodnoty, kukátko nebo místních hodnot a vybrat možnost přerušit při změně hodnoty v místní nabídce.

2. Do pole adresa zadejte adresu paměti nebo výraz, který se vyhodnotí na adresu paměti. Například zadejte, že &avar se má přerušit, když se změní obsah proměnné avar .

3. V rozevíracím seznamu počet bajtů vyberte počet bajtů, které má ladicí program sledovat. Pokud například vyberete 4, ladicí program bude sledovat čtyři bajty počínaje &avar a přerušit, pokud kterákoli z těchto bajtů změní hodnotu.

Datové zarážky nefungují za následujících podmínek:

• Proces, který neladí zápisy do umístění v paměti.
• Umístění v paměti je sdíleno mezi dvěma nebo více procesy.
• Umístění v paměti je aktualizováno v rámci jádra. například pokud je paměť předána do 32 ReadFile funkce Windows, paměť bude aktualizována z režimu jádra, takže ladicí program nebude u aktualizace přerušen.
• Kde výraz kukátka je větší než 4 bajty na 32ovém hardwaru a 8 bajtů na 64 bitového hardwaru. Toto je omezení architektury x86.

Správa zarážek v okně zarážky

Okno zarážky můžete použít k zobrazení a správě všech zarážek ve vašem řešení. Toto centralizované umístění je zvláště užitečné ve velkých řešeních nebo pro složité scénáře ladění, kde jsou zarážky kritické.

V okně zarážky můžete vyhledat, seřadit, filtrovat, povolit nebo zakázat nebo odstranit zarážky. Můžete také nastavit podmínky a akce nebo přidat novou funkci nebo datovou zarážku.

chcete-li otevřít okno zarážky , vyberte možnost ladění > Windows > zarážky nebo stiskněte klávesovou zkratku Ctrl + + + B.

Chcete-li vybrat sloupce, které mají být zobrazeny v okně zarážky , vyberte možnost Zobrazit sloupce. Vyberte záhlaví sloupce pro seřazení seznamu zarážek podle daného sloupce.

Popisky zarážek

Štítky lze použít k řazení a filtrování seznamu zarážek v okně zarážky .

1. Chcete-li přidat popisek ke zarážce, klikněte pravým tlačítkem myši na zarážku v okně zdrojového kódu nebo v okně zarážky a pak vyberte Upravit popisky. Přidejte nový popisek nebo zvolte existující a pak vyberte OK.
2. V okně zarážky seřaďte seznam zarážek tak, že vyberete popisky, podmínky nebo jiná záhlaví sloupců. Výběrem možnosti Zobrazit sloupce na panelu nástrojů můžete vybrat sloupce, které chcete zobrazit.

Export a import zarážek

Chcete-li uložit nebo sdílet stav a umístění zarážek, můžete je exportovat nebo importovat.

• Chcete-li exportovat jednu zarážku do souboru XML, klikněte pravým tlačítkem myši na zarážku v okně zdrojového kódu nebo zarážky a vyberte exportovat nebo Exportovat vybrané. Vyberte umístění exportu a pak vyberte Uložit. Výchozím umístěním je složka řešení.
• Chcete-li exportovat několik zarážek, zaškrtněte v okně zarážky pole vedle zarážek nebo zadejte vyhledávací kritéria do vyhledávacího pole. Vyberte exportovat všechny zarážky, které odpovídají ikoně aktuálního kritéria hledání , a uložte soubor.
• Chcete-li exportovat všechny zarážky, zrušte výběr všech polí a nechte pole Hledat prázdné. Vyberte exportovat všechny zarážky, které odpovídají ikoně aktuálního kritéria hledání , a uložte soubor.
• Chcete-li importovat zarážky, vyberte v okně zarážky položku importovat zarážky z ikony souboru , přejděte do umístění souboru XML a vyberte možnost otevřít.

Nastavení zarážek z okna ladicího programu

Můžete také nastavit zarážky z okna ladicího programu zásobníku volání a zpětný překlad .

Nastavení zarážky v okně zásobník volání

Chcete-li přerušit instrukci nebo čáru, na kterou se volání funkce vrátí, můžete nastavit zarážku v okně zásobník volání .

Nastavení zarážky v okně zásobník volání:

1. Chcete-li otevřít okno zásobník volání , je nutné pozastavit během ladění. vyberte ladit > Windows > zásobník volání nebo stiskněte klávesovou zkratku Ctrl + Alt + C.

2. V okně zásobník volání klikněte pravým tlačítkem myši na volání funkce a vyberte zarážku > Vložit zarážku nebo stiskněte klávesu F9.

   Symbol zarážky se zobrazí vedle názvu volání funkce na levém okraji zásobníku volání.

Zarážka zásobníku volání se zobrazí v okně zarážky jako adresa s umístěním v paměti, které odpovídá další spustitelné instrukci ve funkci.

Ladicí program se v instrukci přerušuje.

Další informace o zásobníku volání naleznete v tématu Postupy: použití okna zásobník volání.

Chcete-li vizuálně sledovat zarážky během provádění kódu, viz metody map v zásobníku volání při ladění.

Nastavení zarážky v okně zpětný překlad

1. Chcete-li otevřít okno zpětný překlad , je nutné pozastavit během ladění. vyberte ladit > Windows > zpětný překlad nebo stiskněte klávesovou zkratku Ctrl + Alt + D.

2. V okně zpětný překlad klikněte na levý okraj instrukce, na kterou chcete přerušit. Můžete ji také vybrat a stisknout klávesu F9 nebo kliknout pravým tlačítkem a vybrat zarážku > Vložit zarážku.

Viz také

• Co je ladění?
• Zápis lepšího kódu C# pomocí Visual Studio
• První pohled na ladění
• řešení potíží se zarážkami v ladicím programu Visual Studio