Dela via


Skapa objektmallar

I den här artikeln beskrivs hur du skapar en objektmall med hjälp av guiden Exportera mall eller manuellt, samt hur du redigerar och använder objektmallar. Om mallen består av flera filer kan du även läsa Så här skapar du objektmallar för flera filer.

Lägga till en objektmall

  1. Skapa eller öppna ett projekt i Visual Studio.

  2. Välj Projekt>Lägg till nytt objekt eller tryck på Ctrl+Skift+A.

  3. I dialogrutan Lägg till nytt objekt väljer du ett objekt och väljer sedan Lägg till för att lägga till det i projektet.

  4. Ändra objektet efter behov och ange var i objektet, om någonstans, parameterbyte ska ske. Mer information finns i Så här: Ersättningsparametrar i en mall.

  5. Spara objektet.

  6. Välj Mall för projektexport>. Exportmallsguiden öppnas.

  7. På sidan Välj malltyp väljer du Objektmall, väljer det projekt som innehåller objektet och väljer sedan Nästa.

  8. På sidan Välj objekt att exportera väljer du det objekt som du vill skapa en mall för och väljer sedan Nästa.

  9. På sidan Välj artikelreferenser väljer du eventuella sammansättningsreferenser som ska ingå i mallen och väljer sedan Nästa.

  10. På sidan Välj mallalternativ :

    • Ange mallens namn och valfri beskrivning, ikonbild och förhandsgranskningsbild.

      Ikonfiler för objekt är .ico filer, enligt beskrivningen i Bilder och ikoner för Visual Studio. Förhandsgranskningsbilden är en bild på 200 x 200 som visas i dialogrutan Lägg till nytt objekt . Du kan ladda ned Visual Studio-avbildningsbiblioteket för att få ikoner som överensstämmer med Visual Studio-formatet.

    • Välj om du vill importera mallen automatiskt till Visual Studio och visa ett utforskarfönster i mappen för utdatafiler.

  11. Välj Slutför.

Mallfilerna komprimeras till en .zip fil och kopieras till katalogen som visas i guiden under Utdataplats. Standardplatsen är %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

Om du har valt Importera mallen automatiskt till Visual Studio läggs även den.zip filen till i användarens ItemTemplates-katalog . Standardplatsen är %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Du kan nu använda objektmallen i dina projekt.

Använd objektmallen

  1. Om du inte valde Importera mallen automatiskt till Visual Studio när du skapade mallen kopierar du .zip filen till katalogen ItemTemplates . Standardplatsen är %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Stäng Visual Studio och öppna det sedan igen.
  3. Skapa ett nytt projekt eller öppna ett befintligt projekt och välj Lägg>till nytt objekt
  4. Välj objektmallen i dialogrutan Lägg till nytt objekt . Om du har lagt till en beskrivning i guiden Exportera mall visas beskrivningen till höger i dialogrutan.
  5. Välj Lägg till för att lägga till mallobjektet i projektet.

Redigera .vstemplate-filen

Guiden skapar en grundläggande mall, men i vissa fall måste du ändra VSTEMPLATE-filen manuellt när du har exporterat mallen. Om du till exempel vill att objektet ska visas i dialogrutan Lägg till nytt objekt för ett universellt Windows-appprojekt måste du redigera .vstemplate-filen .

  1. Extrahera den exporterade objektmallen .zip filen och öppna .vstemplate-filen i Visual Studio.
  2. Redigera filen efter behov. För ett C# Universal Windows-projekt lägger du till <TemplateID>Microsoft.CSharp.Class</TemplateID> i elementet <TemplateData> .
  3. Spara och stäng .vstemplate-filen och ersätt den i .zip-filen .

Aktivera mallar för specifika projektundertyper

Du kan redigera .vstemplate-filen för att ange att objektmallen endast ska visas för vissa projektundertyper, till exempel Windows, Office, Databas eller Webb.

  1. Öppna .vstemplate-filen för redigering.
  2. Lägg till ett ProjectSubType-element omedelbart efter elementet ProjectType , med värdet Windows, Office, Database, eller Web. Till exempel: <ProjectSubType>Database</ProjectSubType>.

I följande exempel visas en .vstemplate-fil för Office projekt.

<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
   <TemplateData>
      <Name>Class</Name>
      <Description>An empty class file</Description>
      <Icon>Class.ico</Icon>
      <ProjectType>CSharp</ProjectType>
      <ProjectSubType>Office</ProjectSubType>
      <DefaultName>Class.cs</DefaultName>
   </TemplateData>
   <TemplateContent>
      <ProjectItem>Class1.cs</ProjectItem>
   </TemplateContent>
</VSTemplate>

Skapa en artikelmall manuellt

I stället för att använda guiden kan du skapa en objektmall manuellt från grunden.

  1. Skapa ett projekt och lägg till ett objekt.
  2. Ändra objektet efter behov, till exempel att lägga till var eventuell parameterersättning ska ske, och spara objektet.
  3. Skapa en XML-fil och spara den med filnamnstillägget .vstemplate i samma katalog som projektobjektfilen.
  4. Lägg till metadata för objektmallar i .vstemplate XML-filen, som du ser i föregående exempel. Mer information finns i Referens för mallschema (utökningsbarhet).
  5. Spara och stäng .vstemplate-filen .
  6. I Utforskaren i Windows väljer du de filer som du vill inkludera i mallen, inklusive .vstemplate-filen . Högerklicka på markeringen och välj Komprimera till>ZIP-fil.
  7. Kopiera den resulterande .zip filen och klistra in den på platsen för Visual Studio-användarobjektmallen. Standardkatalogen är %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.