Balení a nasazení vlastní Moje rozšíření (Visual Basic)

Článek
08/11/2011

Visual Basic poskytuje snadnou cestu k implementování vlastních rozšíření oboru názvů My pomocí šablon aplikace Visual Studio. Pokud vytváříte šablonu projektu, pro kterou je Váše rozšíření My nedílnou součástí nového typu projektu, můžete zahrnout pouze váš vlastní kód rozšíření My k projektu, když exportujete šablonu. Další informace o exportování šablon projektů naleznete v tématu Postupy: Tvorba šablon projektů.

Pokud vaše vlastní rozšíření My je jeden kódový souboru, můžete exportovat soubor jako šablonu položky, kterou uživatelé mohou přidat do libovolného typu projektu jazyka Visual Basic. Potom můžete přizpůsobit šablonu položka k zpřístupnění dalších možností a chování pro vaše vlastní rozšíření My v projektu Visual Basic. Mezi tyto možnosti patří:

Umožňuje uživatelům spravovat vaše vlastní rozšíření My z stránky Moje přípony v Návrháři projektů jazyka Visual Basic.
Automatické přidávání vašich vlastních rozšíření My, když dojde přidání odkazu na specifické sestavení do projektu.
Skrytí šablony položky rozšíření My v dialogovém okně Přidat položka tak, že není součástí seznamu položek projektu.

Toto téma popisuje jak zabalit vlastní rozšíření My jako skrytou šablonu položky, kterou lze spravovat ze stránky Moje přípona v Návrháři projektů jazyka Visual Basic. Vlastní rozšíření My lze také přidat automaticky při přidání odkazu na specifické sestavení do projektu.

Vytvoření oboru názvů pro rozšíření My

Prvním krokem při vytváření balíčku pro nasazení pro vlastní rozšíření My je vytvořit rozšíření jako jeden kódový soubor. Pro podrobné informace a pokyny, jak vytvořit vlastní rozšíření My, viz Rozšíření oboru názvů My v jazyce Visual Basic.

Exportování oboru názvů rozšíření My jako šablonu položky

Po tom, co máte kódový soubor, který obsahuje váš obor názvů rozšíření My, můžete exportovat kódový soubor jako šablonu položky Visual Studio. Pokyny o tom, jak exportovat soubor, jako šablonu položky Visual Studio, viz Postupy: Vytvořit šablony položky.

Poznámka

Pokud váš obor názvu rozšíření My obsahuje závislost na určitém sestavení, můžete přizpůsobit vaši šablonu položky tak, aby automaticky instaloval váš obor názvu rozšíření My, když je přidán odkaz na sestavení. V důsledku toho budete chtít vyloučit tento odkaz na sestavení při exportu kódového souboru jako šablonu položky Visual Studio.

Přizpůsobení šablony položky

Můžete povolit šabloně položka, aby byla spravovatelná ze stránky Moje rozšíření v Návrhaří projektů jazyka Visual Basic. Můžete také povolit šabloně položky automatické přidávání, když je přidán odkaz na specifické sestavení do projektu. Chcete-li povolit tyto úpravy, přidejte nový soubor, označovaný jako CustomData soubor do vaší šablony a potom přidejte nový element jazyka XML v souboru .vstemplate.

Přidání CustomData souboru

Soubor CustomData je textový soubor, který má příponu .CustomData (název souboru lze nastavit na libovolnou smysluplnou hodnota) a obsahuje jazyk XML. Jazyk XML v souboru CustomData dává pokyny do jazyka Visual Basic pro zahrnutí vašich rozšíření My při použití stránky Moje přípona v designeru projektů jazyka Visual Basic. Volitelně můžete přidat atribut <AssemblyFullName> do XML souboru CustomData. Toto poskytne pokyn jazyku Visual Basic k automatickému instalování vašich vlastních rozšíření My při přidání nového odkazu na konkrétní sestavení do projektu. Můžete použít libovolný textový nebo XML editor k vytvoření souboru CustomData a poté jej přidat do komprimované složky šablon položek (soubor ZIP).

Například následující kód jazyka XML obsahuje obsah souboru CustomData, který přidá šablonu položky do složky My Extensions v projektu jazyka Visual Basic v případě, že je do projektu přidán odkaz na sestavení Microsoft.VisualBasic.PowerPacks.Vs.dll.

<VBMyExtensionTemplate 
    ID="Microsoft.VisualBasic.Samples.MyExtensions.MyPrinterInfo" 
    Version="1.0.0.0"
    AssemblyFullName="Microsoft.VisualBasic.PowerPacks.vs"
/>

Soubor CustomData obsahuje element <VBMyExtensionTemplate> , který má atributy uvedené v následující tabulce.

Atribut	Popis
ID	Povinné. Jedinečný identifikátor rozšíření. Jestliže přípona, které má toto ID již byla přidána do projektu, uživatel nebude k jejímu přidání vyzván.
Version	Povinné. Číslo verze šablona položky.
AssemblyFullName	Nepovinné. Název sestavení Pokud je odkaz na toto sestavení přidán do projektu, uživateli se zobrazí výzva k přidání rozšíření My této šablony položky.

Přidání <CustomDataSignature> elementu do souboru .vstemplate

K identifikaci vaší šablony položky Visual Studio jako oboru názvů rozšíření My, musíte také upravit soubor .vstemplate pro vaší šablonu položky. Musíte přidat element <CustomDataSignature> do elementu <TemplateData>. Element <CustomDataSignature> musí obsahovat text Microsoft.VisualBasic.MyExtension, jak je ukázáno v následujícím příkladu.

<CustomDataSignature>Microsoft.VisualBasic.MyExtension</CustomDataSignature>

Nemůžete modifikovat soubory přímo v komprimované složce (.zip soubory). Musíte zkopírovat soubor .vstemplate z komprimované složky, změnit jej a potom nahradit soubor .vstemplate v komprimované složce aktualizovanou kopií.

Následující příklad zobrazuje obsah souboru .vstemplate, který má element <CustomDataSignature> přidán.

<VSTemplate Version="2.0.0" xmlns="https://schemas.microsoft.com/developer/vstemplate/2005" Type="Item">
  <TemplateData>
    <DefaultName>MyCustomExtensionModule.vb</DefaultName>
    <Name>MyPrinterInfo</Name>
    <Description>Custom My Extensions Item Template</Description>
    <ProjectType>VisualBasic</ProjectType>
    <SortOrder>10</SortOrder>
    <Icon>__TemplateIcon.ico</Icon>
    <CustomDataSignature
      >Microsoft.VisualBasic.MyExtension</CustomDataSignature>
  </TemplateData>
  <TemplateContent>
    <References />
    <ProjectItem SubType="Code" 
                 TargetFileName="$fileinputname$.vb"
                 ReplaceParameters="true"
     >MyCustomExtensionModule.vb</ProjectItem>
  </TemplateContent>
</VSTemplate>

Nainstalujte šablonu

Pokud chcete nainstalovat šablonu, můžete zkopírovat komprimovanou složku (.zip soubory) do složky šablon položek jazyka Visual Basic(například Dokumenty\Visual 2008\Templates\Item Templates\Visual Basic). Alternativně můžete publikovat šablona jako soubor Instalační služby aplikace Visual Studio (.vsi). Informace o publikování šablony jako souboru Instalační služby aplikace Visual Studio, naleznete v tématu Postupy: Publikování šablon projektů.