Fragmenty kódu a jejich použití

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 Try...Finally jsou nebo If...Else bloky. 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 výběru fragmentu kódu, a může mít název zástupce, který můžete zadat pro vložení fragmentu kódu. 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.

Rozšiřující fragmenty kódu a obklopování fragmenty 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á prostorový fragment kódu a je k dispozici 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:

  1. V editoru kódu umístěte kurzor nebo vyberte kód C# nebo C++, kam chcete fragment kódu přidat.

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

    • Na řádku nabídek sady Visual Studio zvolte Upravit>fragment kódu pro vložení IntelliSense>nebo Upravit>prostředí IntelliSense>Obklopit.
    • Klikněte pravým tlačítkem myši a v místní nabídce zvolte Fragment>kódu vložit fragment kódu nebo Fragment kódu>obklopovat.
    • Z klávesnice stiskněte kombinaci kláves Ctrl+K, X pro rozšiřující fragment kódu nebo Ctrl+K, S pro prostorový fragment kódu.
  3. 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řidání fragmentu rozšíření

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

try
{

}
finally
{

}

Přidání tohoto fragmentu rozšíření:

  1. V editoru kódu umístěte kurzor na místo, kam chcete přidat fragment kódu.
  2. Klikněte pravým tlačítkem myši a vyberte Vložit fragment kódu z místní nabídky po kliknutí pravým tlačítkem myši nebo použijte řádek nabídek nebo klávesové příkazy.
  3. 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.

Tip

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 fragmentu kódu jazyka C++ je možné zástupce if použít buď jako fragment kódu vložení, nebo jako obklopit fragment kódu. 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:

  1. V místní nabídce zobrazené po kliknutí pravým tlačítkem myši v souboru kódu jazyka Visual Basic vyberte Fragment>kódu vložit fragment kódu.
  2. Vyberte vlastnosti vzorů>kódu, procedury, události>definují 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 na newPropertyValue m_property, všechny výskyty newPropertyValue změn. Pokud změníte String v Int deklaraci vlastnosti, hodnota v Set metodě 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.

Ošetření výjimek

Fragment kódu Try...Catch obvykle zachytí a znovu zvětší 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.

Zabezpečení

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 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 si fragmenty kódu jenom z webů, kterým důvěřujete, a používejte aktuální antivirový software.

Otevřete všechny stažené soubory fragmentů kódu v Poznámkový blok 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é si stáhnete fragment kódu. 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.