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.exe" aufrufen, geben Sie den Namen einer Textvorlagendatei als Argument an. "TextTransform.exe" ruft das Texttransformationsmodul auf und verarbeitet die Textvorlage. TextTransform.exe wird normalerweise von Skripts aufgerufen. In der Regel ist es nicht erforderlich, weil Sie Texttransformation entweder in Visual Studio oder im Buildvorgang ausführen können.

Hinweis

Wenn Sie Texttransformation als Teil eines Buildprozesses ausführen möchten, erwägen Sie, die MSBuild-Texttransformationsaufgabe zu 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 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:

\Program Files\Common Files\Microsoft Shared\TextTemplating\11.0

TextTransform [<options>] <templateName>

Parameter

Argument

Beschreibung

templateName

Identifiziert den Namen der Vorlagendatei, die Sie transformieren möchten.

Option

Beschreibung

-out <filename>

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 <includedirectory>

Ein Verzeichnis, das die in der angegebenen Textvorlage enthaltenen Textvorlagen enthält.

-P <referencepath>

Ein Verzeichnis, um nach in der Textvorlage angegebenen Assemblys zu suchen oder zum Verwenden der -r-Option.

Beispiel: Verwenden Sie zum Einschließen von Assemblys, die für das Visual Studio-API verwendet werden,

-P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"

-dp <processorName>!<className>!<assemblyName|codeBase>

Der Name, der vollständige Typname und die Assembly eines Direktivenprozessors, der verwendet werden kann, um benutzerdefinierte Direktiven innerhalb der Textvorlage zu verarbeiten.

-a [processorName]![directiveName]!<parameterName>!<parameterValue>

Warnung

Geben Sie immer „!“) Markierungen, auch wenn Sie die Prozessor- und optionalen Namen der Direktive angeben.Beispiele:

-a !!param!value

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 ResolveParameterValue für den Zugriff auf die Parameterwerte von einem Direktivenprozessor oder einer Textvorlage. Schließen Sie in einer Textvorlage hostspecific mit in der Vorlagendirektive ein, und rufen Sie die Nachricht auf this.Host auf. Beispiele:

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

-h

Stellt Hilfe bereit.

Verwandte Themen

Aufgabe

Thema

Generieren Sie Dateien in einer Visual Studio-Projektmappe.

Generieren von Code zur Entwurfszeit mithilfe von T4-Textvorlagen

Schreiben Sie Direktivenprozessoren, um eigene Datenquellen zu transformieren.

Anpassen der T4-Texttransformation

Schreibt einen Textvorlagenhost, der es Ihnen ermöglicht, Textvorlagen von der eigenen Anwendung aufzurufen.

Verarbeiten von Textvorlagen mithilfe eines benutzerdefinierten Hosts