Megosztás a következőn keresztül:


Elemsablonok létrehozása

Ez a cikk bemutatja, hogyan hozhat létre elemsablont a Sablon exportálása varázslóval vagy manuálisan, és hogyan szerkesztheti és használhatja az elemsablonokat. Ha a sablon több fájlból áll, olvassa el a How to: Create Multi-file item templates című témakört is.

Elemsablon hozzáadása

  1. Hozzon létre vagy nyisson meg egy projektet a Visual Studióban.

  2. Válassza a Projekt>Új elem hozzáadása lehetőséget, vagy nyomja le a Ctrl+Shift+A billentyűkombinációt.

  3. Az Új elem hozzáadása párbeszédpanelen jelöljön ki egy elemet, majd válassza a Hozzáadás lehetőséget a projekthez való hozzáadásához.

  4. Módosítsa az elemet tetszés szerint, és jelezze, hogy az elemben, ha bárhol hol kell elvégezni a paramétercserét. További információ : Hogyan helyettesítheti a paramétereket egy sablonban.

  5. Mentse az elemet.

  6. Válassza a Projekt>exportálási sablon lehetőséget. Megnyílik az Export Template Wizard.

  7. A Sablontípus kiválasztása lapon válassza az Elemsablon lehetőséget, válassza ki az elemet tartalmazó projektet, majd kattintson a Tovább gombra.

  8. Az Exportálandó elem kiválasztása lapon válassza ki azt az elemet, amelyhez sablont szeretne létrehozni, majd kattintson a Tovább gombra.

  9. A Cikkreferenciák kiválasztása lapon válassza ki a sablonban szerepeltetni kívánt szerelvényhivatkozásokat, majd kattintson a Tovább gombra.

  10. A Sablonbeállítások kiválasztása lapon:

    • Adja meg a sablon nevét és opcionális leírását, ikonképét és előnézeti képét.

      Az elemek ikonfájljai .ico fájlok, a Visual Studio képei és ikonjai című témakörben leírtak szerint. Az előnézeti kép egy 200 x 200 képpontos kép, amely az Új elem hozzáadása párbeszédpanelen jelenik meg. Letöltheti a Visual Studio képtárát , hogy a Visual Studio stílusának megfelelő ikonokat kapjon.

    • Válassza ki, hogy automatikusan importálja-e a sablont a Visual Studióba , és megjeleníti-e az Explorer ablakot a kimeneti fájlok mappájában.

  11. Válassza ki a Befejezésopciót.

A sablonfájlokat a rendszer .zip fájlba tömöríti, és a varázsló Kimeneti hely területén látható könyvtárba másolja. Az alapértelmezett hely %USERPROFILE%\Documents\Visual Studio <version>\My Export Templates.

Ha a sablon automatikus importálása a Visual Studióba lehetőséget választotta, a .zip fájl a felhasználói ItemTemplates könyvtárba is hozzáadódik. Az alapértelmezett hely %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Most már használhatja az elemsablont a projektjeiben.

Az elemsablon használata

  1. Ha a sablon létrehozásakor nem választotta a sablon automatikus importálása a Visual Studióba lehetőséget, másolja a .zip fájlt az ItemTemplates könyvtárba. Az alapértelmezett hely %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Zárja be a Visual Studiót, majd nyissa meg újra.
  3. Hozzon létre egy új projektet, vagy nyisson meg egy meglévő projektet, és válassza a Projekt>Új elem hozzáadása lehetőséget
  4. Válassza ki az elemsablont az Új elem hozzáadása párbeszédpanelen. Ha a Sablon exportálása varázslóban adott hozzá leírást, a leírás a párbeszédpanel jobb oldalán jelenik meg.
  5. Válassza a Hozzáadás lehetőséget a sablonelem projekthez való hozzáadásához.

A .vstemplate fájl szerkesztése

A varázsló létrehoz egy alapsablont, de bizonyos esetekben manuálisan kell módosítania a .vstemplate fájlt a sablon exportálása után. Ha például azt szeretné, hogy az elem megjelenjen egy univerzális Windows-alkalmazásprojekt Új elem hozzáadása párbeszédpaneljén, szerkesztenie kell a .vstemplate fájlt.

  1. Bontsa ki az exportált elemsablont .zip fájlt, és nyissa meg a .vstemplate fájlt a Visual Studióban.
  2. Szükség szerint szerkessze a fájlt. C# univerzális Windows-projekt esetén adja hozzá <TemplateID>Microsoft.CSharp.Class</TemplateID> az elemet.<TemplateData>
  3. Mentse és zárja be a .vstemplate fájlt, és cserélje le a .zip fájlba.

Sablonok engedélyezése adott projektaltípusokhoz

A .vstemplate fájl szerkesztésével megadhatja, hogy az elemsablon csak bizonyos projektaltípusoknál jelenjen meg, például Windows, Office, Database vagy Web.

  1. Nyissa meg a .vstemplate fájlt szerkesztésre.
  2. Adjon hozzá egy ProjectSubType elemet közvetlenül az ProjectType elem után, értékkel Windows, Office, Database, vagy Web. Például: <ProjectSubType>Database</ProjectSubType>.

Az alábbi példa egy .vstemplate fájlt mutat be a projektekhez Office .

<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>

Cikksablon manuális létrehozása

A varázsló használata helyett manuálisan is létrehozhat egy elemsablont.

  1. Hozzon létre egy projektet, és adjon hozzá egy elemet.
  2. Módosítsa az elemet igény szerint, például adja meg a paramétercsere helyét, és mentse az elemet.
  3. Hozzon létre egy XML-fájlt, és mentse . vstemplate fájlkiterjesztéssel ugyanabba a könyvtárba, mint a projektelemfájlt.
  4. Adja hozzá az elemsablon metaadatait a .vstemplate XML-fájlhoz az előző példában látható módon. További információ: Sablonséma-referencia (bővíthetőség).
  5. Mentse és zárja be a .vstemplate fájlt.
  6. A Windows Intézőben válassza ki a sablonba felvenni kívánt fájlokat, beleértve a .vstemplate fájlt is. Kattintson a kiválasztásra a jobb gombbal, majd válassza a Komprimálás ide:>ZIP fájl lehetőséget.
  7. Másolja ki az eredményül kapott .zipfájlt , és illessze be a Visual Studio felhasználói elem sablonjának helyére. Az alapértelmezett könyvtár %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.