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.exe zadáte název textového souboru šablony jako argument. TextTransform.exe volá modul transformace textu a zpracovává text šablonu. TextTransform.exe je obvykle volán 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í úlohy transformace 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:

\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE

pro edici Professional nebo

\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE

pro edici Enterprise.

Syntaxe

TextTransform [<options>] <templateName>

Parametry

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

Možnost	Popis
-out<název souboru>	Soubor, do kterého se zapíše výstup transformace.
-r<sestavení>	Sestavení použité k kompilaci a spuštění textové šablony.
-u<– obor názvů>	Obor názvů, který se používá k kompilaci šablony.
-I<includedirectory>	Adresář, který obsahuje textové šablony zahrnuté v zadané textové šabloně.
Referenční cesta -P<>	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. Do textové šablony zahrňte hostspecific do direktivy šablony a vyvoláte zprávu na this.Host. Pří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. Příklad: -a !!param!value
-h	Poskytuje nápovědu.

Související obsah

• Vytvoření kódu v době návrhu pomocí textových šablon T4
• Přizpůsobení transformace textu T4
• Zpracování textových šablon pomocí vlastního hostitele