T4-Texttransformation anpassen

Textvorlagen sind ein Feature von Visual Studio, mit dem Sie Programmcode oder andere Textdateien über einen Transformationsprozess generieren können. Mithilfe des Visual Studio SDK können Sie den Standardmäßigen Vorlagentransformationsprozess erweitern, indem Sie den Textvorlagendirektivenprozessor oder den Textvorlagenhost anpassen.

In diesem Abschnitt

Der Textvorlagentransformationsprozess: Beschreibt die Funktionsweise der Texttransformation und erläutert die Rolle des Vorlagenhosts und der Direktivenverarbeiter.

Erstellen von benutzerdefinierten T4-Textvorlagen-Direktivenprozessoren: Der Direktivenverarbeiter befasst sich mit Direktiven in Ihrer Vorlage, wie z. B. <#@template#>.. Er wird während der Kompilierung der Vorlage ausgeführt und kann Assemblys und andere Ressourcen laden. Es kann auch Code einfügen, der Ressourcen zur Laufzeit lädt. Indem Sie Ihren eigenen Direktivenprozessor definieren, können Sie die Komplexität Ihrer Vorlagen verringern.

Aufrufen der Texttransformation in einer VS-Erweiterung: Wenn Sie eine Visual Studio-Erweiterung wie einen Menübefehl oder Ereignishandler schreiben, kann die Erweiterung den Text-Templating-Dienst verwenden, um eine beliebige Textvorlage zu transformieren. Sie können Parameterdaten mithilfe des Session-Objekts an die Vorlage übergeben und die Werte aus der Vorlage mithilfe der <#@parameter#> Direktive abrufen.

Verarbeiten von Textvorlagen mithilfe eines benutzerdefinierten Hosts: Wenn der Code der Textvorlage ausgeführt wird, bietet der Host Zugriff auf externe Dateien und den Status der Anwendung. Beispielsweise kann der Host, der Texttransformationen in Visual Studio ausführt, Zugriff auf den Solution Explorer bieten. Außerdem werden Fehler im Fehlermeldungsfenster angezeigt. Wenn Sie Texttransformationen in einem anderen Kontext ausführen möchten, können Sie Ihren eigenen Host definieren, der Zugriff auf die in diesem Kontext verfügbaren Dienste ermöglicht.

Wenn Sie eine Visual Studio-Erweiterung schreiben, sollten Sie den vorhandenen Texttransformationsdienst verwenden, anstatt Ihren eigenen Host zu schreiben. Weitere Informationen finden Sie unter "Aufrufen der Texttransformation in einer VS-Erweiterung".

Verwandte Inhalte

• Das Schreiben einer T4-Textvorlage stellt die Syntax von Textvorlagendirektiven und Steuerelementblöcken bereit.