Sdílet prostřednictvím

Vytváření šablon položek

  • Článek

V tomto článku se dozvíte, jak vytvořit šablonu položky pomocí Průvodce exportem šablony. Pokud se vaše šablona bude skládat z více souborů, přečtěte si téma Postupy: Vytvoření šablon položek s více soubory.

Přidání šablony položky do dialogového okna Přidat novou položku

  1. Vytvořte nebo otevřete projekt v sadě Visual Studio.

  2. Přidejte položku do projektu a upravte ji, pokud chcete.

  3. Upravte soubor kódu tak, aby označil, kde má proběhnout nahrazení parametru. Další informace naleznete v tématu Postupy: Nahrazení parametrů v šabloně.

  4. V nabídce Projekt zvolte Exportovat šablonu.

  5. Na stránce Zvolit typ šablony zvolte Možnost Šablona položky, vyberte projekt, který položku obsahuje, a pak zvolte Další.

  6. Na stránce Vybrat položku k exportu zvolte položku, pro kterou chcete vytvořit šablonu, a pak zvolte Další.

  7. Na stránce Vybrat odkazy na položky vyberte odkazy na sestavení, které chcete zahrnout do šablony, a pak zvolte Další.

  8. Na stránce Vybrat možnosti šablony zadejte název šablony a volitelný popis, obrázek ikony a náhled obrázku a pak zvolte Dokončit. Soubory ikon pro položky jsou .ico soubory, jak je popsáno v obrázcích a ikonách sady Visual Studio – typy souborů. Obrázek náhledu je obrázek 200 x 200, který se zobrazí v dialogovém okně Přidat novou položku .

    V knihovně obrázků sady Visual Studio můžete hledat ikony konzistentní se stylem sady Visual Studio.

    Soubory šablony se přidají do souboru .zip a zkopírují se do adresáře, který jste zadali v průvodci. Výchozí umístění je %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

  9. Pokud jste v Průvodci exportem šablony nevybrali možnost Automaticky importovat šablonu do sady Visual Studio, vyhledejte exportovanou šablonu. Potom ho zkopírujte do adresáře šablony položky uživatele. Výchozí umístění je %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

  10. Zavřete Visual Studio a pak ho znovu otevřete.

  11. Vytvořte nový projekt nebo otevřete existující projekt a pak zvolte Přidat novou položku projektu>nebo stiskněte ctrl+Shift+A.

    Šablona položky se zobrazí v dialogovém okně Přidat novou položku . Pokud jste přidali popis v Průvodci exportem šablony, zobrazí se popis na pravé straně dialogového okna.

Povolení použití šablony položky v projektu univerzální aplikace pro Windows

Průvodce většinu práce provede vytvořením základní šablony, ale v mnoha případech potřebujete po exportu šablony ručně upravit soubor .vstemplate . Pokud například chcete, aby se položka zobrazila v dialogovém okně Přidat novou položku pro projekt univerzální aplikace pro Windows, musíte provést několik dalších kroků.

  1. Pokud chcete exportovat šablonu položky, postupujte podle kroků v předchozí části.

  2. Extrahujte .zip soubor, který byl vytvořen, a otevřete soubor .vstemplate v sadě Visual Studio.

  3. Pro projekt univerzálního systému Windows jazyka C# přidejte do elementu <TemplateData> následující kód XML:

    <TemplateID>Microsoft.CSharp.Class</TemplateID>

  4. V sadě Visual Studio uložte soubor .vstemplate a zavřete ho.

  5. Zkopírujte a vložte soubor .vstemplate zpět do souboru .zip .

    Pokud se zobrazí dialogové okno Kopírovat soubor, zvolte možnost Kopírovat a nahradit.

Nyní můžete přidat položku založenou na této šabloně do univerzálního projektu Systému Windows z dialogového okna Přidat novou položku .

Povolení šablon pro konkrétní podtypy projektu

Můžete určit, že se vaše šablona má zobrazit jenom pro určité podtypy projektu, jako jsou Windows, Office, Databáze nebo Web.

  1. ProjectType Vyhledejte prvek v souboru .vstemplate pro šablonu položky.

  2. Přidejte element ProjectSubType bezprostředně za ProjectType element.

  3. Nastavte textová hodnota prvku na jednu z následujících hodnot:

    • Windows
    • Office
    • Databáze
    • Web

Například: <ProjectSubType>Database</ProjectSubType>.

Následující příklad ukazuje šablonu položky pro projekty 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>

Ruční vytvoření šablony položky

V některých případech můžete chtít šablonu položky vytvořit ručně od začátku.

  1. Vytvořte projekt a položku projektu.

  2. Upravte položku projektu, dokud nebude připravena k uložení jako šablony.

  3. Upravte soubor kódu tak, aby označil, kde má dojít k nahrazení parametru, pokud kdekoli. Další informace o nahrazení parametrů naleznete v tématu Postupy: Nahrazení parametrů v šabloně.

  4. Vytvořte soubor XML a uložte ho s příponou souboru .vstemplate ve stejném adresáři jako soubor položky projektu.

  5. Upravte soubor XML .vstemplate tak, aby poskytoval metadata šablony položky. Další informace naleznete v tématu Referenční informace k schématu šablony (rozšiřitelnost) a příklad v předchozí části.

  6. Uložte soubor .vstemplate a zavřete ho.

  7. V Průzkumníku Windows vyberte soubory, které chcete zahrnout do šablony. Klikněte pravým tlačítkem myši na výběr a zvolte Možnost Odeslat do>komprimované (komprimované) složky. Vybrané soubory se komprimují do .zip souboru.

  8. Zkopírujte soubor .zip a vložte ho do umístění šablony položky uživatele. Výchozí adresář je %USERPROFILE%\Documents\Visual Studio 2022\Templates\ItemTemplates. Další informace naleznete v tématu Postupy: Vyhledání a uspořádání šablon projektů a položek.

Související obsah