Použití fragmentů kódu v Visual Studio

Fragmenty kódu jsou malé bloky opakovaně použitelného kódu, které můžete přidat do souboru kódu. Fragmenty kódu obvykle obsahují často používané konstrukce, například bloky Try...Finally nebo If...Else. K přidání celých tříd nebo metod můžete použít také fragmenty kódu.

Fragment kódu má název, který použijete k jeho výběru, a může mít klávesovou zkratku, kterou zadáte pro vložení. Fragmenty kódu můžou také obsahovat náhradní parametry, které fungují jako zástupné symboly. Visual Studio poskytuje fragmenty kódu pro mnoho jazyků, včetně C#, C++ a Visual Basic.

Předpoklady

  • Visual Studio s nainstalovanou podporou programovacího jazyka, který chcete použít. Dostupné fragmenty kódu závisí na nainstalovaných úlohách a komponentách jazyka.
  • Soubor kódu otevřený v editoru a rozpoznaný příslušnou službou jazyka. V případě příkladu v jazyce C++ otevřete soubor .cpp nebo .h.

Seznámení s typy fragmentů kódu

Visual Studio podporuje dva typy fragmentů kódu:

  • Rozšiřující fragment kódu přidá kód do zadaného místa vložení.
  • surround-with úryvek kódu přidá kód kolem vybraného kódu. Obklopování fragmentů kódu je k dispozici pouze pro C# a C++.

Vyhledání dostupných fragmentů kódu

Chcete-li zobrazit nainstalované fragmenty kódu pro jazyk, vyberte Nástroje> nebo stiskněte Ctrl+K, Ctrl+B. Ve Správci fragmentů kódu vyberte jazyk ze seznamu Jazyků .

Pokud chcete vytvořit a importovat vlastní fragment kódu, aby se zobrazil v seznamu fragmentů kódu, přečtěte si téma Návod: Vytvoření fragmentu kódu v sadě Visual Studio.

Note

Klávesové zkratky se můžou lišit podle profilu nastavení, kontextu, rozložení klávesnice a vlastních vazeb kláves. Pokud chcete najít vazbu pro příkaz, přečtěte si téma Identifikace a přizpůsobení klávesových zkratek.

Vložit rozšiřovací úryvek

Rozšiřující fragment kódu vloží kód do místa vložení. Například fragment kódu jazyka C# tryf přidá try/finally blok:

try
{

}
finally
{

}

Musíte vložit fragment tryf tam, kde je příkaz platný, například uvnitř metody, indexeru, přístupového prvku vlastnosti nebo přístupového prvku události.

  1. V editoru kódu umístěte kurzor na místo, kam chcete přidat fragment kódu.

  2. Proveďte jednu z následujících akcí:

    • Na panelu nabídek vyberte Upravit>IntelliSense>.
    • Klikněte pravým tlačítkem myši a vyberte Úryvek kódu>Vložit úryvek kódu.
    • Stiskněte Ctrl+K, Ctrl+X.
  3. V nástroji pro výběr fragmentu kódu otevřete složku Visual C# a poklikejte na tryf. Můžete také vybrat tryf a stisknout klávesu Tab nebo Enter.

Blok try/finally se zobrazí v místě vložení a můžete ho přizpůsobit.

Návod

Na platném místě vložení zadejte tryfa potom dvakrát stiskněte klávesu Tab , aby se fragment kódu rozbalil bez otevření výběru fragmentu.

Ohraničení vybraného kódu fragmentem kódu

Fragment kódu pro obalení obalí vybraný kód. Fragment kódu jazyka C++ if například zabalí vybraný řádek return FALSE; do if bloku:

if (true)
{
    return FALSE;
}

Ohraničování vybraného kódu C++:

  1. V souboru .cpp nebo .h vyberte kód, který chcete obálit.

  2. Proveďte jednu z následujících akcí:

    • Na panelu nabídek vyberte Upravit>IntelliSense>Obklopit prvkem.
    • Klikněte pravým tlačítkem myši a vyberte možnost Obklopit příkazem.
  3. Ve výběru úryvků kódu dvakrát klikněte na if nebo vyberte if a stiskněte Tab nebo Enter.

Blok if se zobrazí kolem vybraného kódu. true Zástupný symbol nahraďte podmínkou, kterou chcete vyhodnotit.

Další příklady fragmentů kódu jazyka C++ najdete v tématu Fragmenty kódu Visual C++.

Úprava náhradních polí

Fragmenty kódu můžou obsahovat náhradní pole, která přizpůsobíte po vložení. Když se stejné pole objeví více než jednou, změna jednoho výskytu změní všechny propojené výskyty. Stisknutím klávesy Tab přejděte na další náhradní pole.

Například fragment kódu Visual Basic Definovat vlastnost obsahuje propojená pole pro podkladovou proměnnou, název vlastnosti a typ vlastnosti. Chcete-li jej vložit:

  1. V souboru kódu jazyka Visual Basic klikněte pravým tlačítkem myši na místo, kam chcete vložit vlastnost, a pak vyberte Úryvek>Vložit úryvek.
  2. Vyberte vzorů kódu>vlastnosti, procedury, události>Definujte vlastnost.

Snímek obrazovky nabídky fragmentů kódu jazyka Visual Basic s vybranou možností Definovat vlastnost v části Vlastnosti, procedury a události.

Vloží se následující kód:

Private newPropertyValue As String
Public Property NewProperty() As String
    Get
        Return newPropertyValue
    End Get
    Set(ByVal value As String)
        newPropertyValue = value
    End Set
End Property

Pokud změníte newPropertyValue na m_property, všechny propojené instance newPropertyValue se změní. Pokud změníte typ vlastnosti z String na Integer, všechny propojené instance String se změní na Integer.

Řešení potíží s fragmenty kódu

Pokud fragment kódu nebo příkaz není k dispozici:

  • Ověřte, že Visual Studio rozpozná soubor jako očekávaný programovací jazyk.
  • Ověřte, že je nainstalovaná požadovaná úloha nebo jazyková komponenta.
  • V Nástroje> ověřte, že je pro vybraný jazyk nainstalovaný fragment.
  • Pokud klávesová zkratka nefunguje podle očekávání, pomocí funkce Identifikace a přizpůsobení klávesových zkratek vyhledejte aktuální vazbu příkazu.
  • Zkontrolujte, zda je bod vložení pro vybraný úryvek platný. Například některé fragmenty kódu jazyka C# jsou platné pouze uvnitř metody nebo deklarace typu. Platná umístění vložení v jazyce C# najdete v části Fragmenty kódu jazyka C#.

Zkontrolujte kód vložený pomocí úryvků kódu

Kód fragmentu kódu ukazuje základní způsob, jak provést úlohu. Před použitím v aplikaci zkontrolujte a přizpůsobte vygenerovaný kód. Zvažte, jak kód zpracovává výjimky, přistupuje k prostředkům, ověřuje vstup a chrání tajné kódy.

Zacházejte s fragmenty kódu staženými z internetu stejně jako s jiným kódem staženým z internetu. Stáhněte fragmenty kódu pouze ze zdrojů, kterým důvěřujete, a před jejich importem nebo spuštěním zkontrolujte kód fragmentu a jeho metadata.

V projektech .NET Framework může fragment kódu použít References element k přidání odkazů na projekt. Zkontrolujte prvky Imports a References a ověřte, že důvěřujete odkazovaným sestavením. Další informace najdete v tématu Import oboru názvů a v referenčních informacích o schématu fragmentů kódu.

Viz také