Generieren von Dateien mit dem Hilfsprogramm „TextTransform“

„TextTransform.exe“ ist ein Befehlszeilentool, mit dem Sie eine Textvorlage transformieren können. Wenn Sie „TextTransform.exe“ aufrufen, geben Sie den Namen einer Textvorlagendatei als Argument an. „TextTransform.exe“ ruft die Texttransformations-Engine auf und verarbeitet die Textvorlage. „TextTransform.exe“ wird normalerweise aus Skripts aufgerufen. In der Regel ist dies jedoch nicht erforderlich, weil Sie eine Texttransformation entweder in Visual Studio oder im Buildprozess ausführen können.

Hinweis

Wenn Sie die Texttransformation als Teil eines Buildprozesses ausführen möchten, sollten Sie den MsBuild-Texttransformationstask verwenden. Weitere Informationen finden Sie unter Codegenerierung in einem Buildprozess. Auf einem Computer, auf dem Visual Studio installiert ist, können Sie auch eine Anwendung oder eine Visual Studio-Erweiterung schreiben, die Textvorlagen transformieren kann. Weitere Informationen finden Sie unter Verarbeiten von Textvorlagen mithilfe eines benutzerdefinierten Hosts.

„TextTransform.exe“ befindet sich im folgenden Verzeichnis:

\Programme\Microsoft Visual Studio\2022\Professional\Common7\IDE

(Professional Edition) oder

\Programme\Microsoft Visual Studio\2022\Enterprise\Common7\IDE

(Enterprise Edition).

Syntax

TextTransform [<options>] <templateName>

Parameter

Argument	Beschreibung
templateName	Gibt den Namen der Vorlagendatei an, die Sie transformieren möchten.

Option	Beschreibung
-out<dateiname>	Die Datei, in die die Ausgabe der Transformation geschrieben wird.
-r<assembly>	Eine Assembly, die zum Kompilieren und Ausführen der Textvorlage verwendet wird.
-u<namespace>	Ein Namespace, der zum Kompilieren der Vorlage verwendet wird.
-I<includeverzeichnis>	Ein Verzeichnis, das die in der angegebenen Textvorlage enthaltenen Textvorlagen enthält.
-P<verweispfad>	Ein Verzeichnis, in dem nach Assemblys gesucht werden soll, die in der Textvorlage oder für die Verwendung der Option -r angegeben sind. Um beispielsweise Assemblys einzuschließen, die für die Visual Studio-API verwendet werden, verwenden Sie -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<prozessorName>!<klassenName>!<assemblyName|codeBasis>	Der Name, der vollständige Typname und die Assembly eines Anweisungsprozessors, der zum Verarbeiten benutzerdefinierter Anweisungen innerhalb der Textvorlage verwendet werden kann.
-a [prozessorName]![anweisungsName]!<parameterName>!<parameterWert>	Geben Sie einen Parameterwert für einen Anweisungsprozessor an. Wenn Sie nur den Parameternamen und -wert angeben, ist der Parameter für alle Anweisungsprozessoren verfügbar. Wenn Sie einen Anweisungsprozessor angeben, ist der Parameter nur für den angegebenen Prozessor verfügbar. Wenn Sie einen Anweisungsnamen angeben, ist der Parameter nur verfügbar, wenn die angegebene Anweisung verarbeitet wird. Verwenden Sie ITextTemplatingEngineHost.ResolveParameterValue, um auf die Parameterwerte aus einem Anweisungsprozessor oder einer Textvorlage zuzugreifen. Fügen Sie hostspecific in einer Textvorlage in die Vorlagenanweisung ein, und rufen Sie die Nachricht für this.Host auf. Beispiel: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Geben Sie immer die Zeichen „!“ ein, auch wenn Sie die optionalen Prozessor- und Anweisungsnamen auslassen. Beispiel: -a !!param!value
-h	Stellt Hilfe bereit.

Zugehöriger Inhalt

• Generieren von Code zur Entwurfszeit mithilfe von T4-Textvorlagen
• Anpassen der T4-Texttransformation
• Verarbeiten von Textvorlagen mithilfe eines benutzerdefinierten Hosts