Přizpůsobení transformace textu T4

Textové šablony jsou funkcí sady Visual Studio, která umožňuje generovat kód programu nebo jiné textové soubory prostřednictvím procesu transformace. Pomocí sady Visual Studio SDK můžete rozšířit výchozí proces transformace šablony přizpůsobením procesoru direktiv textových šablon nebo hostitele textových šablon.

V této části

Proces transformace textové šablony: Popisuje, jak funguje transformace textu, a vysvětluje roli hostitele šablony a procesory direktiv.

Vytváření vlastních procesorů direktiv textových šablon T4: Procesor direktiv zpracovává direktivy ve vaší šabloně, jako je <#@template#>.. Běží během kompilace šablony a může načítat sestavení a další prostředky. Může také vložit kód, který bude načítat prostředky za běhu. Definováním vlastního procesoru direktiv můžete snížit složitost šablon.

Vyvolání transformace textu v rozšíření VS: Pokud píšete rozšíření sady Visual Studio, jako je například příkaz nabídky nebo obslužná rutina události, může vaše rozšíření k transformaci libovolné textové šablony použít službu šablon textu. Data parametrů můžete do šablony předat pomocí objektu Session a získat hodnoty z šablony pomocí direktivy <#@parameter#> .

Zpracování textových šablon pomocí vlastního hostitele: Když se spustí kód textové šablony, hostitel poskytuje přístup k externím souborům a stavu aplikace. Hostitel, který spouští transformace textu v sadě Visual Studio, může například poskytnout přístup k Průzkumníku řešení. Zobrazuje také chyby v okně chybové zprávy. Pokud chcete spouštět transformace textu v jiném kontextu, můžete definovat vlastního hostitele, který poskytuje přístup ke službám dostupným v tomto kontextu.

Pokud píšete rozšíření pro Visual Studio, zvažte použití existující služby pro transformaci textu, namísto abyste psali vlastní hostitelské prostředí. Další informace najdete v tématu Vyvolání transformace textu v rozšíření VS.

Související obsah

• Napište textovou šablonu T4 , která poskytuje syntaxi direktiv textových šablon a řídicích bloků.