Fragmenty kódu a jejich použití

2025-06-12

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é bloky kódu, jako 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žíváte k jeho výběru, a může mít zkratku pro vložení. Fragmenty kódu můžou také obsahovat náhradní parametry, které fungují jako zástupné symboly. Fragmenty kódu jsou k dispozici pro mnoho jazyků, včetně C#, C++ a Visual Basicu.

Úseky rozšíření kódu a úseky pro obklopení kódu

Do kódu můžete přidat dva druhy fragmentů kódu:

Rozšiřující fragment se přidá do zadaného místa vložení.
Kolem vybraného kódu se přidá fragment obklopit s a je dostupný pouze pro C# a C++.

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

Pokud chcete zobrazit dostupné fragmenty kódu pro jazyk , vyberte>v řádku nabídek správce fragmentů kódu nástroje nebo stiskněte ctrl+K, B a pak v rozevírací nabídce vyberte požadovaný jazyk.

Snímek obrazovky s dialogovým oknem Správce fragmentů kódu

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.

Přidání fragmentu kódu do souboru kódu

Přidání fragmentu kódu do souboru kódu:

V editoru kódu umístěte kurzor nebo vyberte kód C# nebo C++, kam chcete fragment kódu přidat.
Proveďte jednu z následujících akcí:
- Na řádku nabídek sady Visual Studio zvolte Upravit>IntelliSense>Vložit fragment nebo Upravit>IntelliSense>Obklopit s.
- Klikněte pravým tlačítkem myši a v místní nabídce zvolte Fragment kódu>Vložit fragment nebo Fragment kódu>Obklopit fragmentem.
- Z klávesnice stiskněte kombinaci kláves Ctrl+K, X pro rozšiřující úryvek nebo Ctrl+K, S pro fragment kódu obklopující.
Poklikejte na požadovaný fragment kódu v rozevíracím seznamu nebo zadejte zástupce fragmentu kódu a stiskněte klávesu Tab nebo Enter.

Přidat úryvek rozšíření

Například fragment rozšíření tryf jazyka C# přidá následující Try...Finally blok:

try
{

}
finally
{

}

Pro přidání tohoto fragmentu rozšíření:

V editoru kódu umístěte kurzor na místo, kam chcete přidat fragment kódu.
Klikněte pravým tlačítkem myši a vyberte Vložit fragment z místní nabídky, nebo použijte nabídku či klávesové zkratky.
Otevřete složku Visual C# a potom poklikejte na tryf v rozevíracím seznamu nebo vyberte tryf a stiskněte klávesu Tab nebo Enter.

Návod

Kurzor můžete také umístit na místo vložení, zadat tryf a potom dvakrát stisknout klávesu Tab .

Přidání ohraničního fragmentu kódu

V následujícím příkladu ukázky kódu v jazyce C++ je možné zástupce if použít buď jako úryvek pro vložení, nebo jako úryvek kódu pro obklopení. Pokud vyberete řádek return FALSE; kódu a pak zvolíte Možnost Obklopit s>if, fragment kódu se rozbalí kolem řádku.

if (true)
{
    return FALSE;
}

Parametry nahrazení fragmentu kódu

Fragmenty kódu můžou obsahovat náhradní parametry, což jsou zástupné symboly, které musíte nahradit, aby odpovídaly kódu, který píšete. V předchozím příkladu true je náhradní parametr, který nahradíte příslušnou podmínkou. Nahrazení se opakuje pro každou instanci tohoto náhradního parametru v fragmentu kódu.

Visual Basic má například fragment kódu, který definuje vlastnost. Vložení fragmentu kódu:

V místní nabídce zobrazené po kliknutí pravým tlačítkem myši v souboru kódu jazyka Visual Basic vyberte Fragment>Vložení Fragmentu.
Vyberte vzorů kódu>vlastnosti, procedury, události>Definujte vlastnost.

Snímek obrazovky s nabídkou fragmentu kódu pro definování vlastnosti

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 výskyty newPropertyValue se změní. Pokud v deklaraci vlastnosti změníte String na Int, hodnota v metodě Set se také změní na Int.

Osvědčené postupy pro používání fragmentů kódu

Kód v fragmentu kódu ukazuje jenom nejzásadnější způsob, jak něco udělat. U většiny aplikací je nutné kód upravit tak, aby vyhovoval aplikaci.

Zpracování výjimek

Fragmenty kódu Try...Catch obvykle zachytí a znovu vyvolají všechny výjimky, ale to nemusí být pro váš projekt správnou volbou. Pro každou výjimku existuje několik způsobů, jak reagovat. Příklady najdete v tématu Postup zpracování výjimky pomocí příkazu try/catch (C#) a try... Chytit... Příkaz Finally (Visual Basic)

Umístění souborů

Při úpravě umístění souborů pro aplikaci nezapomeňte zvážit následující faktory.

Vyhledejte přístupné umístění. Uživatelé nemusí mít přístup ke složce Program Files počítače, takže ukládání uživatelských souborů se soubory aplikace nemusí fungovat.
Najděte bezpečné umístění. Ukládání souborů do kořenové složky, jako je C:\ , není zabezpečené. Pro data aplikací je nejlepší použít složku Data aplikace . Pro jednotlivá uživatelská data může aplikace vytvořit soubor ve složce Dokumenty každého uživatele.
Použijte platný název souboru. Pomocí ovládacích OpenFileDialog prvků a SaveFileDialog ovládacích prvků můžete snížit pravděpodobnost neplatných názvů souborů.
Mějte na paměti, že soubor vybraný uživatelem je možné odstranit předtím, než s ním váš kód může manipulovat. Uživatel také nemusí mít oprávnění k zápisu do souboru.

Bezpečnost

Zabezpečení fragmentu kódu závisí na tom, kde ho použijete ve zdrojovém kódu a jak ho upravíte, jakmile bude v kódu. Následující seznam obsahuje několik oblastí, které je potřeba vzít v úvahu:

Přístup k souborům a databázím
Zabezpečení přístupu ke kódu
Ochrana prostředků, jako jsou protokoly událostí a registr
Ukládání tajných kódů
Ověřování vstupů
Předávání dat skriptovacím technologiím

Další informace najdete v tématu Zabezpečení aplikací.

Stažené fragmenty kódu

Fragmenty kódu nainstalované sadou Visual Studio nejsou bezpečnostní rizika sama. Můžou ale ve vaší aplikaci vytvářet bezpečnostní rizika. Fragmenty kódu stažené z internetu by se měly zacházet s extrémní opatrností, stejně jako s jakýmkoli jiným staženým obsahem. Stáhněte fragmenty kódu jenom z webů, kterým důvěřujete, a použijte up-to-date virus software.

Otevřete všechny stažené soubory fragmentů kódu v Poznámkovém bloku nebo editoru XML sady Visual Studio a před instalací je pečlivě zkontrolujte. Dávejte pozor na následující problémy:

Fragment kódu, který by mohl poškodit systém, pokud ho spustíte. Před spuštěním zdrojového kódu si ho pečlivě přečtěte.
HelpURL blokuje soubory fragmentů kódu obsahující adresy URL, které spouštějí škodlivé soubory skriptů nebo zobrazují urážlivé weby.
Fragmenty kódu obsahující odkazy, které se do projektu přidávají bezobslužně a lze je načíst odkudkoliv ve vašem systému. Tyto odkazy si můžete stáhnout ze stejného umístění, ze kterého si stáhnete úryvek. Fragment kódu pak může volat metodu v odkazu, která spouští škodlivý kód. Pokud chcete takové odkazy zjistit, zkontrolujte Imports a References bloky souboru fragmentu kódu.