Använda kodfragment i Visual Studio

Kodfragment är små block med återanvändbar kod som du kan lägga till i en kodfil. Kodfragment innehåller vanligtvis ofta använda konstruktioner som Try...Finally eller If...Else block. Du kan också använda kodfragment för att lägga till hela klasser eller metoder.

Ett kodfragment har en rubrik som du använder för att välja den och kan ha en genväg som du skriver för att infoga den. Kodfragment kan också innehålla ersättningsparametrar som fungerar som platshållare. Visual Studio innehåller kodfragment för många språk, inklusive C#, C++ och Visual Basic.

Förutsättningar

  • Visual Studio med stöd installerat för det programmeringsspråk som du vill använda. Vilka kodfragment som är tillgängliga beror på de installerade arbetsbelastningarna och språkkomponenterna.
  • En kodfil öppnas i redigeraren och identifieras av lämplig språktjänst. För C++-exemplet öppnar du en fil av typen .cpp eller .h.

Förstå kodfragmenttyper

Visual Studio stöder två typer av kodfragment:

  • En expansionssnutt lägger till kod på en angiven infogningspunkt.
  • Ett surround-with-kodfragment lägger till kod runt markerad kod. Surround-with-kodfragment är endast tillgängliga för C# och C++.

Hitta tillgängliga kodfragment

Om du vill visa de installerade kodfragmenten för ett språk väljer du Verktyg>Kodfragmenthanteraren eller trycker på Ctrl+K, Ctrl+B. I Kodfragmenthanteraren väljer du ett språk i listan Språk .

Information om hur du skapar och importerar ett eget kodfragment så att det visas i kodfragmentlistan finns i Genomgång: Skapa ett kodfragment i Visual Studio.

Note

Kortkommandon kan variera beroende på inställningsprofil, kontext, tangentbordslayout och anpassade nyckelbindningar. Information om hur du hittar bindningen för ett kommando finns i Identifiera och anpassa kortkommandon.

Infoga ett expansionsfragment

Ett expansionsfragment infogar kod vid insättningspunkten. C#- tryf kodfragmentet lägger till exempel till ett try/finally block:

try
{

}
finally
{

}

Du måste infoga kodfragmentet tryf där en instruktion är giltig, till exempel i en metod, indexerare, egenskapsåtkomst eller händelseåtkomst.

  1. Placera markören i kodredigeraren där du vill lägga till kodfragmentet.

  2. Välj en av följande åtgärder:

    • På menyraden väljer du Redigera>IntelliSense>Infoga kodfragment.
    • Högerklicka och välj Kodfragment>Infoga kodfragment.
    • Tryck på Ctrl+K, Ctrl+X.

  3. Öppna mappen Visual C# i kodfragmentväljaren och dubbelklicka sedan på tryf. Du kan också välja tryf och trycka på Tabb eller Retur.

Blocket try/finally visas vid insättningspunkten, redo att anpassas.

Tips/Råd

Vid en giltig insättningspunkt skriver du tryfoch trycker sedan på Tabb två gånger för att expandera kodfragmentet utan att öppna kodfragmentväljaren.

Omge markerad kod med ett kodfragment

Ett surround-med-kodfragment omsluter vald kod. Till exempel omsluter C++ if -kodfragmentet den markerade raden return FALSE; i ett if block:

if (true)
{
    return FALSE;
}

Så här omger du markerad C++-kod:

  1. I en .cpp-fil eller .h-fil markerar du koden som du vill omsluta.

  2. Välj en av följande åtgärder:

    • På menyraden väljer du Redigera>IntelliSense>Surround Med.
    • Högerklicka och välj Omslut med.

  3. I kodfragmentsväljaren dubbelklickar du på if, eller väljer if och trycker på Tab eller Enter.

Blocket if visas runt den valda koden. true Ersätt platshållaren med det villkor som du vill utvärdera.

Fler C++-kodfragmentexempel finns i Visual C++-kodfragment.

Redigera ersättningsfält

Kodfragment kan innehålla ersättningsfält som du anpassar efter infogning. När samma fält förekommer mer än en gång ändras alla länkade förekomster när en av dem ändras. Tryck på Tabb för att flytta till nästa ersättningsfält.

Till exempel innehåller Visual Basic Definiera ett egenskapsfragment länkade fält för bakgrundsvariabeln, egenskapsnamnet och egenskapstypen. Så här infogar du den:

  1. I en Visual Basic kodfil högerklickar du på den plats där du vill infoga egenskapen och väljer sedan Infoga kodfragment>.
  2. Välj Egenskaper för kodmönster>, procedurer, händelser>Definiera en egenskap.

Skärmbild av Visual Basic kodfragmentväljaren med Definiera en egenskap som valts under Egenskaper, Procedurer, Händelser.

Följande kod infogas:

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

Om du ändrar newPropertyValue till m_property, ändras varje länkad instans av newPropertyValue. Om du ändrar egenskapstypen från String till Integerändras varje länkad instans av String till Integer.

Felsök kodavsnitt

Om ett kodfragment eller kommando inte är tillgängligt:

  • Bekräfta att Visual Studio identifierar filen som förväntat programmeringsspråk.
  • Kontrollera att den nödvändiga arbetsbelastningen eller språkkomponenten är installerad.
  • I Verktyg>Kodfragmenthanteraren kontrollerar du att kodfragmentet är installerat för det valda språket.
  • Om ett kortkommando inte fungerar som förväntat använder du Identifiera och anpassa kortkommandon för att söka efter kommandots aktuella bindning.
  • Kontrollera att insättningspunkten är giltig för det valda kodfragmentet. Vissa C#-kodfragment är till exempel bara giltiga i en metod- eller typdeklaration. Giltiga C#-infogningsplatser finns i C#-kodfragment.

Granska kod som infogats med kodfragment

Kodfragment visar ett grundläggande sätt att utföra en uppgift. Granska och anpassa den genererade koden innan du använder den i ett program. Överväg hur koden hanterar undantag, kommer åt resurser, validerar indata och skyddar hemligheter.

Behandla kodfragment som laddats ned från Internet som annan nedladdad kod. Ladda endast ned kodfragment från källor som du litar på och granska kodfragmentkoden och metadata innan du importerar eller kör det.

I .NET Framework-projekt kan ett kodfragment använda elementet References för att lägga till projektreferenser. Granska elementen Imports och References och kontrollera att du litar på de refererade sammansättningarna. Mer information finns i Importera ett namnområde och schemareferensen för kodfragment.

Se även

  • Last updated on