Freigeben über


Generieren von Dateien mit dem Hilfsprogramm "TextTransform"

TextTransform.exe ist ein Befehlszeilentool, mit dem Sie eine Textvorlage transformieren können. Wenn Sie TextTransform.exeaufrufen, geben Sie den Namen einer Textdatei als Argument an. TextTransform.exe ruft das Texttransformationsmodul auf und verarbeitet die Textvorlage. TextTransform.exe wird in der Regel von Skripts aufgerufen. Dies ist jedoch in der Regel nicht erforderlich, da Sie texttransformationen 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 die MSBuild-Texttransformationsaufgabe 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:

Syntax

TextTransform [<options>] <templateName>

Die Parameter

Argument Beschreibung
templateName Gibt den Namen der Vorlagendatei an, die Sie transformieren möchten.
Auswahl Beschreibung
-aus<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.
-Ich<includedirectory> Ein Verzeichnis, das die Textvorlagen enthält, die in der angegebenen Textvorlage enthalten sind.
-P<Referenzpfad> Ein Verzeichnis zum Suchen nach Assemblys, die in der Textvorlage angegeben sind, oder zum Verwenden der Option -r.

Zum Beispiel, um Assemblys einzuschließen, die für die Visual Studio-API verwendet werden, sollten Sie verwenden

-P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-DP<processorName>!<className>!<assemblyName|codeBase> Der Name, der vollständige Typname und die Assembly eines Direktivenprozessors, der zum Verarbeiten von benutzerdefinierten Direktiven innerhalb der Textvorlage verwendet werden kann.
-a [processorName]![directiveName]!<parameterName>!<parameterValue> Geben Sie einen Parameterwert für einen Direktivenprozessor an. Wenn Sie nur den Parameternamen und den Wert angeben, steht der Parameter allen Direktivenprozessoren zur Verfügung. Wenn Sie einen Direktivenprozessor angeben, ist der Parameter nur für den angegebenen Prozessor verfügbar. Wenn Sie einen Direktivennamen angeben, ist der Parameter nur verfügbar, wenn die angegebene Direktive verarbeitet wird.

Verwenden Sie ITextTemplatingEngineHost.ResolveParameterValue, um auf die Parameterwerte von einem Direktivenprozessor oder einer Textvorlage zuzugreifen. Fügen Sie hostspecific in die Directiven einer Textvorlage ein, und rufen Sie die Nachricht unter this.Host auf. Beispiel:

<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>].

Geben Sie immer die "!"-Markierungen ein, auch wenn Sie die optionalen Prozessor- und Direktivennamen weglassen. Beispiel:

-a !!param!value
-h Stellt Hilfe bereit.