Zavedení směrnice vlastní procesor

Použít vlastní procesor směrnice v Visual Studio v libovolném počítači, je třeba název zaregistrovat podle jedné z metod popsaných v tomto tématu.

Alternativní metody jsou:

• Rozšíření aplikace Visual Studio (VSIX).To umožňuje nainstalovat a odinstalovat směrnice procesoru v počítači i v jiných počítačích.Můžete obvykle balíček dalších funkcí ve stejné VSIX.

• VSPackage.Pokud definujete VSPackage, obsahující další funkce kromě směrnice procesoru, je pohodlný způsob registrace směrnice procesoru.

• Nastavte klíč registru.V této metodě přidejte položku registru směrnice procesoru.

Je nutné použít jednu z těchto metod pouze tehdy, pokud chcete transformovat text šablony v Visual Studio nebo MSBuild.Pokud používáte vlastní hostitele ve vlastní aplikaci, vaše vlastní hostitele pro vyhledání směrnice procesorů pro jednotlivé směrnice odpovídá.

Zavedení směrnice procesoru v VSIX

Můžete přidat k vlastní směrnice procesoru Rozšíření aplikace Visual Studio (VSIX).

Je třeba zajistit, že následující dvě položky jsou obsaženy v souboru .vsix:

• Sestavení (DLL), která obsahuje vlastní směrnice procesor třídy.

• Soubor .pkgdef, který zaregistruje směrnice procesoru.Kořenový název souboru musí být stejné jako sestavení.Soubory mohou být například název CDP.dll a CDP.pkgdef.

Zkontrolovat nebo změnit obsah souboru .vsix, změňte jeho příponu na ZIP a otevřete jej.Po úpravě obsahu, změňte název souboru zpět do .vsix.

Existuje několik způsobů vytváření souboru .vsix.Následující postup popisuje jednu metodu.

Vyvinout vlastní procesor směrnice v projektu VSIX

1. Vytvoření projektu VSIX v Visual Studio.

   • V Nový projekt dialogovém okně pole, rozbalte položku jazyka Visual Basic nebo Visual C#, rozbalte rozšíření.Klepněte na VSIX projektu.

2. V source.extension.vsixmanifest, nastavit typ obsahu a podporovaná.

   1. V manifestu editoru VSIX, klepněte na tlačítko Přidání obsahu a nastavte jeho vlastnosti následujícím způsobem:

      Typ obsahu = VSPackage

      Zdrojový projekt = <aktuální projekt>

   2. Klepněte na tlačítko Vybrané edice a zkontrolujte typy instalace, na kterém je použitelná směrnice procesoru.

3. Přidat soubor .pkgdef a nastavte jeho vlastnosti, které mají být zahrnuty do VSIX.

   1. Vytvořte textový soubor s názvem <assemblyName> .pkgdef.

      <assemblyName> je obvykle stejné jako název projektu.

   2. Vyberte v aplikaci Solution Explorer a nastavte jeho vlastnosti následujícím způsobem:

      Vytvořit akci = obsahu

      Kopírovat do výstupní adresář = Vždy kopírovat

      Zahrnout do VSIX = True

   3. Nastavit název VSIX a ujistěte se, že je jedinečný Identifikátor.

4. Přidejte následující text do souboru .pkgdef.

   [$RootKey$\TextTemplating]
   [$RootKey$\TextTemplating\DirectiveProcessors]
   [$RootKey$\TextTemplating\DirectiveProcessors\ CustomDirectiveProcessorName]
   @="Custom Directive Processor description"
   "Class"="NamespaceName.ClassName"
   "CodeBase"="$PackageFolder$\AssemblyName.dll"
   

   Následující názvy nahradit vlastní názvy: CustomDirectiveProcessorName, NamespaceName, ClassName, AssemblyName.

5. Přidáte do projektu v následujících odkazech:

   • Microsoft.VisualStudio.TextTemplating.11.0

   • Microsoft.VisualStudio.TextTemplating.Interfaces.11.0

   • Microsoft.VisualStudio.TextTemplating.VSHost.11.0

6. Přidáte vlastní směrnice procesor třídy do projektu.

   To je veřejné třídy, která by měla zavést DirectiveProcessor nebo RequiresProvidesDirectiveProcessor.

Procesor směrnice vlastní instalace

1. V Průzkumníkovi Windows (soubor Explorer 8 v systému Windows) otevřete adresář sestavení (obvykle bin\Debug nebo bin\Release).

2. Pokud chcete nainstalovat směrnice procesoru v jiném počítači, zkopírujte soubor .vsix do jiného počítače.

3. Poklepejte na soubor .vsix.Visual Studio Se zobrazí instalační rozšíření.

4. Restart Visual Studio.Bude nyní možné spustit text šablony obsahující direktivy, které odkazují na vlastní procesor směrnice.Směrnice je tohoto formuláře:

   <#@ CustomDirective Processor="CustomDirectiveProcessorName" parameter1="value1" … #>

Odinstalovat nebo zakázat dočasně vlastní směrnice procesoru

1. V Visual StudioNástroje nabídky, klepněte na tlačítko Extension Manager.

2. VSIX, který obsahuje procesor směrnice vyberte a klepněte na tlačítko Odinstalace nebo Zakázat.

Poradce při potížích směrnice procesoru v VSIX

Pokud směrnice procesoru nefunguje, mohou pomoci následující návrhy:

• Název procesoru, zadáte vlastní směrnice by měla odpovídat CustomDirectiveProcessorName zadaný v souboru .pkgdef.

• Vaše IsDirectiveSupported metoda true Pokud je předán název vašeho CustomDirective.

• Pokud nevidíte rozšíření Extension Manager, ale systém nebude možné ji nainstalovat, odstranit rozšíření ze %localappdata%\Microsoft\VisualStudio\11.0\Extensions\.

• Otevřete soubor .vsix a kontrolovat její obsah.Chcete-li ji otevřít, změňte příponu souboru na ZIP.Ověřte, zda obsahuje soubory DLL, .pkgdef a extension.vsixmanifest.Extension.vsixmanifest soubor by měl obsahovat příslušný seznam v uzlu SupportedProducts a by měl také obsahovat uzel VsPackage obsahu uzlu:

  <Content>

  <VsPackage>CustomDirectiveProcessor.dll</VsPackage>

  </Content>

Zavedení směrnice procesoru v VSPackage

Pokud procesor směrnice je součástí VSPackage, který bude nainstalován v mezipaměti GAC, máte systém generování souboru .pkgdef.

Třída balíčku umístěte následující atribut:

[ProvideDirectiveProcessor(typeof(DirectiveProcessorClass), "DirectiveProcessorName", "Directive processor description.")]

[!POZNÁMKA]

Tento atribut je umístěn na třídě balíček není směrnice procesor třídy.

Při vytváření projektu bude vytvořen soubor .pkgdef.Při instalaci VSPackage soubor .pkgdef bude registrovat směrnice procesoru.

Ověřte, že soubor .pkgdef se zobrazí ve složce sestavení, která je obvykle bin\Debug nebo bin\Release.Pokud není zobrazen v textovém editoru otevřete soubor .csproj a odebrat následující uzel: <GeneratePkgDefFile>false</GeneratePkgDefFile>.

Další informace naleznete v tématu VSPackages.

Nastavení klíče registru

Tato metoda instalace vlastní směrnice procesoru je nejméně upřednostňována.Není poskytují pohodlný způsob, jak povolit a zakázat směrnice procesoru a neposkytuje metodu distribuce směrnice procesoru jiným uživatelům.

Upozornění
Nesprávná úprava registru může vážně poškodit systém.Před prováděním změn registru, nezapomeňte zálohovat veškerá cenná data v počítači.

Registrace směrnice procesoru nastavením klíče registru

1. Spustit regedit z nabídky Start systému Windows.

2. Regedit přejděte do

   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\TextTemplating\DirectiveProcessors

   Pokud chcete instalovat experimentální verze směrnice procesoru Visual Studio, za "11.0" Vložit "Exp".

3. Přidáte klíč registru, který má stejný název jako třída směrnice procesoru.

   • Ve stromu registru, klepněte pravým tlačítkem myši DirectiveProcessors uzel, přejděte na Novýa klepněte na tlačítko klíč.

4. V novém uzlu přidáte řetězec hodnoty pro třídy a CodeBase nebo montáž, podle následující tabulky.

   1. Klepněte pravým tlačítkem myši na uzel, který jste vytvořili, přejděte na příkaz Novýa klepněte na tlačítko Hodnotu řetězce.

   2. Upravte název hodnoty.

   3. Poklepejte na název a upravovat data.

Pokud vlastní směrnice procesor není v mezipaměti GAC, podklíče registru by měla vypadat v následující tabulce:

Název	Type	Data
(Výchozí)	REG_SZ	(hodnota není zadána)
Třída	REG_SZ	< název oboru názvů >. < název třídy >
CodeBase	REG_SZ	< cesta > \ < název sestavení >

Pokud shromáždění v mezipaměti GAC, podklíče registru by měla vypadat v následující tabulce:

Název	Type	Data
(Výchozí)	REG_SZ	(hodnota není zadána)
Třída	REG_SZ	< vaše plně kvalifikovaný název třídy >
Sestavení	REG_SZ	< jméno sestavení v mezipaměti GAC >

Viz také

Koncepty

Vytvoření vlastní T4 Text šablony směrnice procesorů