Delen via

Codefragmenten en hoe ze te gebruiken

Codefragmenten zijn kleine blokken herbruikbare code die u aan een codebestand kunt toevoegen. Snippets bevatten meestal veelgebruikte codeblokken zoals Try...Finally of If...Else blokken. U kunt codefragmenten ook gebruiken om volledige klassen of methoden toe te voegen.

Een codefragment heeft een titel die u gebruikt om het fragment te selecteren en kan een snelkoppelingsnaam hebben die u kunt typen om het fragment in te voegen. Fragmenten kunnen ook vervangende parameters bevatten, die fungeren als tijdelijke aanduidingen. Snippets zijn beschikbaar voor vele talen, waaronder C#, C++ en Visual Basic.

Uitbreidingsfragmenten en surround-met-fragmenten

U kunt twee soorten codefragmenten aan uw code toevoegen:

  • Een uitbreidingsfragment wordt toegevoegd op een opgegeven invoegpunt.
  • Er wordt een surround-with-fragment toegevoegd rond de geselecteerde code en deze is alleen beschikbaar voor C# en C++.

Beschikbare fragmenten zoeken

Als u de beschikbare fragmenten voor een taal wilt weergeven, selecteert u> ToolsCode Snippets Manager in de menubalk of drukt u op Ctrl+K, B en selecteert u vervolgens de gewenste taal in het vervolgkeuzemenu.

Schermafbeelding van het dialoogvenster Code Snippets Manager.

Als u uw eigen fragment wilt maken en importeren zodat het in de lijst met fragmenten wordt weergegeven, raadpleegt u Scenario: Een codefragment maken in Visual Studio.

Een fragment toevoegen aan een codebestand

Een fragment toevoegen aan een codebestand:

  1. Plaats in de code-editor uw cursor of selecteer C#- of C++-code op de plaats waar u het fragment wilt toevoegen.

  2. Ga in dat geval op een van de volgende manieren te werk:

    • Kies op de menubalk van Visual Studio de optieIntelliSense-invoegfragment>bewerken> ofIntelliSense-surround>bewerken>met.
    • Klik met de rechtermuisknop en kies Fragment>invoegen of Fragment>omringen met in het contextmenu.
    • Druk op het toetsenbord op Ctrl+K, X voor een uitbreidingsfragment of Ctrl+K, S voor een omringingsfragment.

  3. Dubbelklik op het gewenste fragment in de vervolgkeuzelijst of typ de snelkoppeling naar het fragment en druk op Tab of Enter.

Een uitbreidingsfragment toevoegen

Het C#-uitbreidingsfragment tryf voegt bijvoorbeeld het volgende Try...Finally blok toe:

try
{

}
finally
{

}

Dit uitbreidingsfragment toevoegen:

  1. Plaats in de code-editor de cursor op de plaats waar u het fragment wilt toevoegen.
  2. Klik met de rechtermuisknop en selecteer Fragment invoegen in het contextmenu met de rechtermuisknop of gebruik de menubalk- of toetsenbordopdrachten.
  3. Open de map Visual C# en dubbelklik vervolgens op tryf in de vervolgkeuzelijst, of selecteer tryf en druk op Tab of Enter.

Aanbeveling

U kunt ook de cursor op de invoegpositie plaatsen, tryf typen en vervolgens twee keer op Tab drukken.

Voeg een randfragment toe

In het volgende voorbeeld van een C++-fragment kan de snelkoppeling if worden gebruikt als een invoegfragment of een omring-met-fragment. Als u de coderegel return FALSE; selecteert en vervolgens Omringen met>als kiest, wordt het fragment rond de regel uitgevouwen.

if (true)
{
    return FALSE;
}

Parameters voor het vervangen van fragmenten

Fragmenten kunnen vervangende parameters bevatten, dit zijn tijdelijke aanduidingen die u moet vervangen om te passen in de code die u schrijft. In het vorige voorbeeld true is een vervangende parameter, die u vervangt door de juiste voorwaarde. De vervanging wordt herhaald voor elk exemplaar van die vervangingsparameter in het fragment.

Visual Basic heeft bijvoorbeeld een codefragment dat een eigenschap definieert. Het fragment invoegen:

  1. Selecteer in het contextmenu met de rechtermuisknop in een Visual Basic-codebestand de optie Fragment>invoegen.
  2. Selecteer Codepatronen>, eigenschappen, procedures, gebeurtenissen>,definieer een eigenschap.

Schermafbeelding van het codefragmentmenu voor Een eigenschap definiëren.

De volgende code wordt ingevoegd:

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

Als u wijzigt newPropertyValue in m_property, verandert elk exemplaar van newPropertyValue wijzigingen. Als u in de eigenschapsdeclaratie wijzigt String in Int , verandert de waarde in de Set methode ook in Int.

Aanbevolen procedures voor het gebruik van codefragmenten

De code in een codefragment toont alleen de meest elementaire manier om iets te doen. Voor de meeste toepassingen moet de code worden aangepast aan de toepassing.

Afhandeling van uitzonderingen

Normaal gesproken vangen codefragmentblokken Try...Catch alle uitzonderingen op en gooien ze deze opnieuw, maar dat is misschien niet de juiste keuze voor uw project. Voor elke uitzondering zijn er verschillende manieren om te reageren. Zie voor voorbeelden Hoe om te gaan met een uitzondering met behulp van proberen/vangen (C#) en Proberen... Vangen... Tot slot statement (Visual Basic).

Bestandslocaties

Wanneer u bestandslocaties aanpast aan uw toepassing, moet u rekening houden met de volgende factoren.

  • Zoek een toegankelijke locatie. Gebruikers hebben mogelijk geen toegang tot de map Programmabestanden van de computer, waardoor het opslaan van gebruikersbestanden met de toepassingsbestanden mogelijk niet werkt.

  • Zoek een veilige locatie. Het opslaan van bestanden in de hoofdmap, zoals C:\ , is niet veilig. Voor toepassingsgegevens kunt u het beste de map Toepassingsgegevens gebruiken. Voor individuele gebruikersgegevens kan de toepassing een bestand maken in de map Documenten van elke gebruiker.

  • Gebruik een geldige bestandsnaam. U kunt de besturingselementen en OpenFileDialog gebruiken om de SaveFileDialog kans op ongeldige bestandsnamen te verkleinen.

  • Houd er rekening mee dat een door de gebruiker geselecteerd bestand kan worden verwijderd voordat uw code het bestand kan manipuleren. Het is ook mogelijk dat een gebruiker niet gemachtigd is om naar het bestand te schrijven.

Veiligheid

De beveiliging van een fragment hangt af van waar u het gebruikt in de broncode en hoe u het wijzigt als het eenmaal in de code staat. De volgende lijst bevat een paar aandachtspunten:

  • Toegang tot bestanden en databases
  • Beveiliging van codetoegang
  • Beveiliging van bronnen zoals gebeurtenislogboeken en registers
  • Geheimen opslaan
  • Invoer verifiëren
  • Gegevens doorgeven aan scripttechnologieën

Zie Toepassingen beveiligen voor meer informatie.

Gedownloade codefragmenten

Codefragmenten die door Visual Studio zijn geïnstalleerd, zijn zelf geen beveiligingsrisico's. Ze kunnen echter beveiligingsrisico's in uw applicatie met zich meebrengen. Fragmenten die van internet zijn gedownload, moeten met uiterste voorzichtigheid worden behandeld, net als alle andere gedownloade inhoud. Download alleen fragmenten van sites die u vertrouwt en gebruik up-to-date virussoftware.

Open alle gedownloade fragmentbestanden in Kladblok of de XML-editor van Visual Studio en controleer ze zorgvuldig voordat u ze installeert. Pas op voor de volgende zaken:

  • Fragmentcode die uw systeem kan beschadigen als u deze uitvoert. Lees de broncode zorgvuldig voordat u deze uitvoert.

  • HelpURL blokken in fragmentbestanden die URL's bevatten die schadelijke scriptbestanden uitvoeren of aanstootgevende websites weergeven.

  • Fragmenten met verwijzingen die op de achtergrond aan uw project worden toegevoegd en die overal op uw systeem kunnen worden geladen. U kunt deze verwijzingen downloaden vanaf dezelfde locatie waar u een fragment downloadt. Het fragment kan dan een methode in de verwijzing aanroepen die schadelijke code uitvoert. Als u dergelijke verwijzingen wilt detecteren, controleert u de Imports en References blokken van het fragmentbestand.

Verwante inhoud