Generera filer med verktyget TextTransform

TextTransform.exe är ett kommandoradsverktyg som du kan använda för att transformera en textmall. När du anropar TextTransform.exeanger du namnet på en textmallfil som ett argument. TextTransform.exe anropar texttransformeringsmotorn och bearbetar textmallen. TextTransform.exe anropas vanligtvis från skript. Det är dock vanligtvis inte nödvändigt eftersom du kan utföra texttransformering antingen i Visual Studio eller i byggprocessen.

Anmärkning

Om du vill utföra texttransformering som en del av en byggprocess bör du överväga att använda texttransformeringsuppgiften MSBuild. Mer information finns i Kodgenerering i en byggprocess. På en dator där Visual Studio är installerat kan du också skriva ett program eller Visual Studio-tillägg som kan transformera textmallar. Mer information finns i Bearbeta textmallar med hjälp av en anpassad värd.

TextTransform.exe finns i följande katalog:

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

för Professional Edition eller

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

för Enterprise-utgåvan.

Syntax

TextTransform [<options>] <templateName>

Parameterar

Argument	Beskrivning
templateName	Identifierar namnet på mallfilen som du vill transformera.

Alternativ	Beskrivning
-ut<filnamn>	Filen som utdata från transformen skrivs till.
-r<assembly>	En sammansättning som används för att kompilera och köra textmallen.
-u<namespace>	Ett namnområde som används för att kompilera mallen.
-Jag<includedirectory>	En katalog som innehåller de textmallar som ingår i den angivna textmallen.
-P<referencepath>	En katalog för att söka efter sammansättningar som anges i textmallen eller för att använda alternativet -r . Om du till exempel vill inkludera sammansättningar som används för Visual Studio-API:et använder du -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	Namn, fullständigt typnamn och sammansättning av en direktivprocessor som kan användas för att bearbeta anpassade direktiv i textmallen.
-a [processorName]![directiveName]!<parameterName>!<parameterValue>	Ange ett parametervärde för en direktivprocessor. Om du bara anger parameternamnet och värdet blir parametern tillgänglig för alla direktivprocessorer. Om du anger en direktivprocessor är parametern endast tillgänglig för den angivna processorn. Om du anger ett direktivnamn är parametern endast tillgänglig när det angivna direktivet bearbetas. Om du vill komma åt parametervärdena från en direktivprocessor eller textmall använder du ITextTemplatingEngineHost.ResolveParameterValue. I en textmall tar du med hostspecific i malldirektivet och anropar meddelandet på this.Host. Till exempel: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Skriv alltid "!"-märkena, även om du utelämnar de valfria processor- och direktivnamnen. Till exempel: -a !!param!value
-h	Ger hjälp.

Relaterat innehåll

• Design-Time kodgenerering med hjälp av T4-textmallar
• Anpassning av T4-texttransformation
• Bearbeta textmallar med hjälp av en anpassad värd