Zobrazení a změna hodnot proměnných pomocí datových tipů v editoru kódu

Tento článek popisuje, jak pracovat s funkcí datových tipů v sadě Visual Studio. Datové tipy poskytují pohodlný způsob zobrazení informací o proměnných v programu při ladění kódu. Když v kódu nastavíte zarážky a spustíte ladění, zobrazí se datové tipy pro proměnné, když zadají aktuální rozsah provádění. Pomocí datového tipu můžete změnit hodnotu proměnné v oboru a znovu spustit kód přes zarážku, abyste viděli efekt změny.

snímek obrazovky ladění v rámci Visual Studio s příklady datových tipů pro proměnné v oboru

Spropitné

Pokud s laděním teprve začínáte, možná si budete chtít přečíst Ladění pro absolutní začátečníky, a techniky ladění a nástroje, než si projdete tento článek.

Požadavky

  • Visual Studio. Pokud sadu Visual Studio nemáte, přejděte na stránku ke stažení Visual Studio a nainstalujte ji zdarma.

  • Nějaký programový kód, který se má spustit v ladicím programu sady Visual Studio.

Práce s datovými tipy

Datové tipy jsou viditelné během ladicí relace, když máte v kódu nastavené body přerušení. Když ladicí program pozastaví provádění programu na bodu přerušení, jsou náhledy dat k dispozici pro všechny proměnné v aktuálním oboru.

Tady je postup:

  1. Nastavte v kódu bod přerušení a začněte ladění tak, že vyberete Ladění>Spustit ladění nebo použijete klávesovou zkratku F5.

  2. Když ladicí program pozastaví provádění na zarážce, najeďte myší na libovolnou proměnnou v aktuálním oboru, aby se otevřel datový tip.

  3. Pomocí datového tipu můžete zobrazit název proměnné a pracovat s hodnotou.

  4. Podle potřeby změňte hodnotu proměnné nebo přidejte komentáře.

Poznámka

Visual Studio vyhodnotí a zobrazí hodnotu proměnné v datovém tipu na základě kontextu, ve kterém je ladicí program pozastaven při spuštění. Vyhodnocení není založené na aktuálním umístění kurzoru nebo datového tipu. Pokud na proměnnou najedete myší v jiné funkci, která má stejný název jako proměnná v aktuálním kontextu, sada Visual Studio zobrazí hodnotu proměnné v datovém tipu pro aktuální kontext.

Visual Studio podporuje mnoho akcí pro tipy k datům a práci s proměnnými a hodnotami, mezi které patří:

  • Připnutím nebo ponecháním datového tipu jej udržíte viditelný, zatímco provádění kódu pokračuje
  • Povolte setrvalé datové tipy, které zůstanou rozbalené, dokud nekliknete jinam
  • Rozbalte datový náhled pro pole, strukturu nebo objekt a zobrazte jeho členy ve stromové struktuře.
  • Změna hodnoty proměnné v datovém tipu
  • Přidejte víceřádkové komentáře k připnutému datovému tipu pro psaní poznámek během ladění
  • Tipy pro import i export data

Zprůhlednit datové tipy

Když na proměnnou najedete myší, abyste zobrazili datový tip, můžete datový tip nastavit jako průhledný, aby se kód zobrazil pod ním. Tato akce také zapne průhlednost dalších akcí tipu v editoru kódu, jako jsou definice metod a syntaxe výrazů.

Pokud chcete povolit transparentnost, postupujte takto:

  1. V editoru Visual Studio Code vyberte uvnitř datového tipu a pak vyberte a podržte klávesu Ctrl.

  2. Pokud chcete zachovat průhlednost, podržte stisknutou klávesu Ctrl.

  3. Pokud chcete ukončit průhlednost, přestaňte vybrat Ctrl nebo vyberte jinou možnost.

Průhlednost není k dispozici pro připnutý nebo volně plovoucí datový tip.

Rozšíření datových tipů

Když v sadě Visual Studio 2022 Update 1 a novějším rozbalíte datový tip, můžete ho nechat rozbalený, dokud nevyberete něco jiného. Tato akce vytvoří rychlý datový tip.

Pokud chcete, aby byl datový tip pevný, postupujte takto:

  1. V sadě Visual Studio vyberte Ladit>Možnosti a otevřete dialogové okno Možnosti.

  2. Na kartě Obecné procházejte, dokud nenajdete možnost Ponechat rozbalené datové tipy otevřené, dokud je nekliknete pryč.

  3. Zaškrtněte políčko, chcete-li povolit pevnou možnost, a vyberte OK.

Pokud je zapnutá možnost sticky, rozbalíte-li v editoru kódu jakýkoli datový tip, zůstane rozbalený.

Připnutí datových tipů

Datový tip můžete připnout, aby zůstal otevřený v editoru kódu. Můžete také změnit umístění připnutého datového tipu.

Pokud chcete připnout datový tip, postupujte takto:

  1. V editoru Visual Studio Code najeďte myší na proměnnou, aby se zobrazil datový tip.

  2. V datovém tipu pomocí připínáčku vyberte Připnout ke zdrojovému:

    snímek obrazovky, který ukazuje, jak připnout popis dat a přesunout ho na libovolné místo na ploše editoru kódu.

    Visual Studio připne datový tip na místo v blízkosti proměnné na ploše kódu. Připínáček se zobrazí v okraji editoru kódu vedle řádku, kde připnete datový tip.

  3. Vyberte a přetáhněte připnutý datový tip na libovolné místo v editoru kódu.

Tipy k datům float (odepnutí)

Po připnutí datového tipu můžete odepnout datový tip a nastavit ho plovoucí. Plovoucí datový tip lze umístit kdekoli v integrovaném vývojovém prostředí sady Visual Studio.

Pokyny pro vytvoření plovoucího datového tipu:

  1. V připnutém datovém tipu pomocí připínáčku vyberte Odepnout ze zdrojového.

    Visual Studio uvolní datový tip a daný tip obarví na plnou barvu pozadí. Špendlík pro datový tip se změní do polohy odepnutého a špendlík v okraji editoru kódu je odstraněn.

    Snímek obrazovky, který ukazuje, jak lze umístit datový tip na libovolné místo v integrovaném vývojovém prostředí sady Visual Studio.

  2. Vyberte a přetáhněte plovoucí datový tip do libovolného umístění v integrovaném vývojovém prostředí sady Visual Studio.

    Pokud umístíte plovoucí datový tip mimo plochu editoru kódu, je špendlík odstraněn z boční nabídky datového tipu. Možnost Připnout ke zdroji je dostupná pouze v případech, kdy je plovoucí datový tip umístěn na ploše editoru kódu.

Tipy pro opětovné připnutí dat

Poté, co umístíte plovoucí datový tip, můžete jej znovu připnout na konkrétní místo v editoru kódu.

Pokud chcete připnout plovoucí datový tip, postupujte takto:

  1. Vyberte a přesuňte plovoucí datový tip a umístěte ho na plochu editoru kódu.

  2. V plovoucím datovém tipu vyberte připínáčkem možnost Připnout ke zdroji.

    Připínáček se změní na připnutou pozici. Tip k datům je připnut na konkrétní místo v editoru kódu a v boční liště editoru se zobrazí připínáček pro zdroj.

Zavřít datové tipy

Existuje několik způsobů, jak můžete zavřít datové bubliny ve Visual Studiu.

Když ukončíte ladicí relaci, pokud máte nějaké otevřené datové tipy, Visual Studio je za vás zavře. Pokud spustíte další ladicí relaci, Visual Studio se pokusí znovu vytvořit všechny datové tipy, které jste předtím opustili otevřené.

Následující tabulka shrnuje, jak můžete ručně zavřít datové tipy:

Blízký cíl Akce
Konkrétní datový tip V datovém tipu vyberte X.
Všechny datové tipy pro konkrétní soubor Vyberte Ladit>Vymazat všechny DataTips připnuté k <názvu souboru> na panelu nástrojů sady Visual Studio.
Všechny otevřené datové tipy Na panelu nástrojů sady Visual Studio vyberte Ladit>a vymazat všechny datatipy.

Práce s proměnnými a hodnotami v datových tipech

Při práci s datovými tipy v sadě Visual Studio získáte možnost zobrazit podrobnosti o proměnných a objektech a upravovat hodnoty během ladění. Tyto funkce jsou užitečné pro rychlé řešení potíží a testování změn kódu.

Rozbalit objekty v datových tipech pro zobrazení členů

Když datový tip představuje matici, strukturu nebo objekt, můžete rozbalit zobrazení datového tipu a zobrazit členy. Rozbalené zobrazení zobrazuje dodatečné informace ve formátu hierarchického stromu.

Chcete-li rozbalit zobrazení objektu v datovém tipu, postupujte takto:

  1. V datovém tipu pro pole, strukturu nebo objekt klikněte na šipku pro rozbalení před názvem položky, aby se zobrazily členy. Zobrazení se zobrazí ve stromovém formátu:

    Snímek obrazovky, který ukazuje, jak vybrat rozbalovací šipku pro objekt v datovém tipu.

    U připnutého datového tipu vyberte symbol plus (+) před názvem proměnné a rozbalte definici.

  2. Pokračujte výběrem rozbalovacích šipek, abyste zobrazili více z hierarchie členů.

    Snímek obrazovky, který ukazuje, jak pokračovat v rozbalení stromu objektů, tak, aby se zobrazil strom členů.

  3. K pohybu nahoru a dolů v rozbaleném zobrazení použijte myš nebo klávesy se šipkami nahoru a dolů.

  4. Chcete-li připojit rozbaleného člena s původním připnutým datovým tipem, použijte připínáček u člena a vyberte možnost Připnout ke zdroji. Po sbalení stromového zobrazení zůstanou všechny připnuté členské prvky viditelné pomocí připnutého datového tipu.

Úprava hodnot proměnných

Další výhodou práce s datovými tipy je možnost upravit hodnotu proměnné nebo prvku v datovém tipu během ladění. Tato funkce je užitečná pro rychlé testování malých změn kódu.

Pokud chcete upravit hodnotu proměnné nebo prvku v datovém tipu, postupujte takto:

  1. V datovém tipu vyberte hodnotu. Visual Studio zvýrazní hodnotu a zpřístupní ji pro úpravy.

  2. Do datového tipu zadejte novou hodnotu a vyberte Enter.

Mějte na paměti, že některé hodnoty proměnných jsou jen pro čtení. Visual Studio nedává k dispozici hodnoty jen pro čtení pro úpravy.

Používejte komentáře v datových tipech

Komentáře oblasti datového tipu je užitečné při ladění kódu uchovávat poznámky o proměnných. Díky tomu je tato oblast vhodným místem pro sledování různých hodnot, jak se mění během ladění. Komentáře můžete přidat do připnutého nebo plovoucího datového tipu.

Pokud chcete použít Komentáře v datovém tipu, postupujte takto:

  1. V datovém tipu pomocí dvojité šipky dolů vyberte Rozbalit, aby se zobrazil komentář. Dvojitá šipka dolů otevře Komentáře oblasti datového tipu, kam můžete přidat poznámky.

  2. Pokud chcete přidat komentář, vložte kurzor do oblasti Komentáře a zadejte text. Oblast přijímá více řádků.

    snímek obrazovky, který ukazuje, jak zadat komentáře do datového tipu

  3. Pokud chcete zavřít oblast Komentáře, pomocí dvojité šipky nahoru sbalit komentáře. Všechny komentáře, které zadáte, zůstanou s datovým tipem, ale momentálně nejsou viditelné.

Připnutí vlastností v datových tipech

Visual Studio podporuje připnutí vlastností v připnutých datových tipech v .NET Core 3.0 a novějších verzích. Tato funkce umožňuje rychle kontrolovat objekty podle jejich vlastností v datových tipech.

Pokud chcete připnout vlastnosti v datových tipech, postupujte takto:

  1. V připnutém datovém tipu rozbalte hierarchii členů, dokud neuvidíte vlastnost, kterou chcete zobrazit pomocí datového tipu.

  2. Pomocí připínáčku pro vlastnost ji připnete pomocí datového tipu. Můžete také kliknout pravým tlačítkem myši na vlastnost a vybrat Připnout člena mezi oblíbené.

    Visual Studio přesune vybranou vlastnost na začátek seznamu vlastností objektu. Název a hodnota vlastnosti se zobrazí v pravém sloupci připnutého datového tipu:

    Snímek obrazovky ukazuje, jak připnout vlastnosti v datovém tipu.

  3. Pokud chcete odepnout vlastnost v datovém tipu, znovu vyberte špendlík pro vlastnost nebo klikněte pravým tlačítkem myši na vlastnost a vyberte Odepnout člena jako oblíbeného.

Můžete také přepnout viditelnost názvů vlastností a vyfiltrovat odepnuté vlastnosti v seznamu vlastností objektu v datovém tipu:

  • Pokud chcete odfiltrovat odepnuté vlastnosti, klikněte pravým tlačítkem myši na řádek vlastnosti v datovém tipu a vyberte Zobrazit pouze připnuté členy.

  • Pokud chcete přepnout viditelnost názvů vlastností, klikněte pravým tlačítkem myši na řádek vlastnosti v datovém tipu a vyberte Skrýt připnuté názvy členů v hodnotách.

Následující obrázek znázorňuje různé možnosti v nabídce zobrazené po kliknutí pravým tlačítkem myši pro hierarchii členů v datovém tipu:

Snímek obrazovky s nabídkou po kliknutí pravým tlačítkem myši pro členy v datovém tipu, který obsahuje možnosti Odepnout člena ze seznamu oblíbených a Zobrazit pouze připnuté členy.

Získání pomoci s AI

Pokud máte Copilot, můžete získat AI asistenci při prohlížení proměnných v datových náhledech. Klikněte pravým tlačítkem na proměnnou a použijte Zeptat se copilotu.Snímek obrazovky tlačítka Zeptat se copilotu. tlačítko. V tomto scénáři už Copilot zná kontext vaší otázky, takže nemusíte v chatu zadávat kontext sami. Další informace naleznete v tématu Ladění s Copilotem.

Vizualizace složitých datových typů

Vizualizéry zobrazují informace smysluplnějším a někdy grafickým způsobem. Příklady vizualizérů zahrnují XML, HTML, JSON a Vizualizér textu. Vizualizace můžete použít k prozkoumání složitých datových typů v kódu během ladění.

Pokud jsou vizualizéry k dispozici pro prvek, Visual Studio zobrazí ikonu lupy Náhled vedle názvu prvku v datovém tipu. Když vyberete vizualizaci, Visual Studio otevře samostatné okno pro zobrazení složitých dat ve čitelném formátu.

Pomocí této funkce můžete vybrat vizualizaci dat:

  • Pokud chcete zobrazit prvek pomocí výchozího vizualizéru pro datový typ, vyberte lupu. Ikona vizualizéru Ikona vizualizéru

  • Pokud chcete vybrat konkrétní vizualizaci, rozbalte rozevírací seznam Zobrazit vedle ikony lupy a zvolte možnost.

Přidání proměnných do sledovacích oken

Proměnné můžete dál sledovat tak, že je přidáte do sledovacího okna sady Visual Studio z datového tipu:

  • V datovém tipu klikněte pravým tlačítkem myši na název proměnné a vyberte Přidat sledování.

Visual Studio přidá proměnnou v okně sledování. Pokud vaše edice sady Visual Studio podporuje více oken Watch, proměnná se zobrazí v okně s popiskem Watch 1.

Tipy pro importu a exportu dat

Tipy k datům můžete exportovat do souboru XML, který můžete sdílet nebo upravovat pomocí textového editoru. Můžete také importovat datové tipy ze souboru XML, který jste obdrželi nebo předtím upravili.

Pokud chcete exportovat tipy k datům, postupujte takto:

  1. V nástroji Visual Studio vyberte Ladění>Exportovat DataTips. Otevře se dialogové okno Exportovat nápovědy.

  2. V dialogovém okně přejděte do umístění, kam chcete soubor XML uložit.

  3. Zadejte název souboru exportu a vyberte Uložit.

Visual Studio exportuje tipy k datům do zadaného souboru a umístění.

Pokud chcete importovat tipy k datům ze souboru, postupujte takto:

  1. V sadě Visual Studio vyberte Ladění>Import datových tipů. Otevře se dialogové okno Import DataTips.

  2. V dialogovém okně vyhledejte umístění souboru XML s datovými tipy pro použití při importu.

  3. Vyberte soubor, který chcete otevřít, a vyberte Otevřít.

Visual Studio naimportuje datové tipy ze zadaného souboru do aktuálního pracovního prostoru. Při ladění kódu v pracovním prostoru jsou k dispozici importované tipy k datům.