Generování souborů pomocí nástroje TextTransform

TextTransform.exe je nástroj příkazového řádku, který můžete použít k transformaci textové šablony. Při volání TextTransform.exezadáte název souboru textové šablony jako argument. TextTransform.exe volá transformační engine a zpracovává textovou šablonu. TextTransform.exe se obvykle volá ze skriptů. Obvykle to ale není nutné, protože transformace textu můžete provést buď v sadě Visual Studio, nebo v procesu sestavení.

Poznámka:

Pokud chcete v rámci procesu sestavení provést transformaci textu, zvažte použití úlohu pro transformaci textu nástroje MSBuild. Další informace najdete v tématu Generování kódu v procesu sestavení. Na počítači, na kterém je sada Visual Studio nainstalovaná, můžete také napsat aplikaci nebo rozšíření sady Visual Studio, které může transformovat textové šablony. Další informace naleznete v tématu Zpracování textových šablon pomocí vlastního hostitele.

TextTransform.exe se nachází v následujícím adresáři:

Syntaxe

TextTransform [<options>] <templateName>

Parametry

argumentu	Description
templateName	Určuje název souboru šablony, který chcete transformovat.

Možnost	Description
-out<jméno souboru>	Soubor, do kterého se zapíše výstup transformace.
-r<assembláž>	Sestavení použité k kompilaci a spuštění textové šablony.
-u<namespace>	Obor názvů, který se používá k kompilaci šablony.
-Já<includedirectory>	Adresář, který obsahuje textové šablony zahrnuté v zadané textové šabloně.
-P<referenční cesta>	Adresář pro vyhledávání sestavení zadaných v textové šabloně nebo pro použití parametru -r . Pokud například chcete zahrnout sestavení používaná pro rozhraní API sady Visual Studio, použijte -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	Název, úplný název a sestavení procesoru direktiv, který lze použít ke zpracování vlastních direktiv v textové šabloně.
-a [processorName]! [directiveName]!<parameterName>!<parameterValue>	Zadejte hodnotu parametru pro procesor direktiv. Pokud zadáte pouze název a hodnotu parametru, bude parametr dostupný pro všechny procesory direktiv. Pokud zadáte procesor direktiv, bude parametr k dispozici pouze pro zadaný procesor. Pokud zadáte název direktivy, parametr je k dispozici pouze při zpracování zadané direktivy. Pro přístup k hodnotám parametrů z procesoru direktiv nebo textové šablony použijte ITextTemplatingEngineHost.ResolveParameterValue. V textové šabloně zahrňte hostspecific do direktivy šablony a vyvolejte zprávu na this.Host. Například: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Vždy zadejte značky '!', i když vynecháte volitelné názvy procesoru a direktiv. Například: -a !!param!value
-h	Poskytuje nápovědu.

Související obsah

• Generování kódu v Design-Time pomocí textových šablon T4
• Přizpůsobení transformace textu T4
• Zpracování textových šablon pomocí vlastního hostitele