Sdílet prostřednictvím

Zpracování textu šablony pomocí vlastní hostitele

  • Článek

Transformace textu šablony proces trvá text šablony jako vstup a vytvoří textový soubor jako výstup.Můžete volat modul transformace textu z Visual Studio rozšíření, nebo samostatná aplikace spuštěné v počítači, na kterém Visual Studio je nainstalován.Je však nutné zadat text templating hostitele.Tato třída připojí šablonu pro životní prostředí, vyhledání zdrojů, například sestavení a zahrnout soubory a zabývají výstup a chybové zprávy.

Tip

Pokud vytváříte balíček nebo rozšíření, který bude spuštěn v rámci Visual Studio, zvažte použití služeb templating text, namísto psaní vlastního hostitele.Další informace naleznete v tématu Transformace textu v rozšíření VS vyvolání.

[!POZNÁMKA]

Nedoporučujeme použití transformace textu šablony v serverových aplikací.Nedoporučujeme pomocí šablony transformace textu kromě jediného podprocesu.Důvodem je text templating stroj re-uses jediné domény AppDomain přeložit, kompilaci a spouštění šablon.Přeložený kód se podprocesu není určen.Motor je určen ke zpracování souborů sériově, jako v Visual Studio projektu v době návrhu.

Pro spuštění aplikace, zvažte použití předzpracovány text šablony: viz Spuštění generování textu s T4 Text šablony.

Pokud aplikace používá sadu šablon, které jsou stanoveny v době kompilace, je jednodušší použít předzpracovány Text šablony.Pokud vaše aplikace poběží na počítač, na kterém můžete také použít tento přístup Visual Studio není nainstalována.Další informace naleznete v tématu Spuštění generování textu s T4 Text šablony.

Provádění Text šablony v aplikaci

Chcete-li text šablony, zavolejte metodu ProcessTemplate Microsoft.VisualStudio.TextTemplating.Engine:

using Microsoft.VisualStudio.TextTemplating;
...
Engine engine = new Engine();
string output = engine.ProcessTemplate(templateString, host);

Musíte najít aplikace a poskytuje šablony a musí čelit výstup.

V host parametr, je nutné zadat třídu, která implementuje ITextTemplatingEngineHost.To se nazývá zpět motoru.

Hostitel musí mít možnost protokolování chyb, vyřešit odkazy na sestavení a zahrnout soubory, poskytují aplikační domény, ve které šablony může provést a volat příslušné procesoru pro jednotlivé směrnice.

Microsoft.VisualStudio.TextTemplating.Engineje definován v Microsoft.VisualStudio.TextTemplating.11.0.dll, a ITextTemplatingEngineHost v Microsoft.VisualStudio.TextTemplating.Interfaces.11.0.dll.

V tomto oddíle

Odkaz

ITextTemplatingEngineHost

Související oddíly