Freigeben über

Anpassen der T4-Texttransformation

  • Artikel

Textvorlagen sind ein Feature von Visual Studio, mit dem Sie Programmcode oder andere Textdateien über einen Transformationsprozess generieren können. Mit dem Visual Studio SDK können Sie den Standardprozess für die Vorlagentransformation erweitern, indem Sie den Anweisungsprozessor für Textvorlagen oder den Textvorlagenhost anpassen.

In diesem Abschnitt

Textvorlagen-Transformationsprozess: Beschreibt die Funktionsweise der Texttransformation und erläutert die Rolle des Vorlagenhosts und der Anweisungsprozessoren.

Erstellen von benutzerdefinierten T4-Anweisungsprozessoren für Textvorlagen: Der Anweisungsprozessor verarbeitet die Anweisungen in Ihrer Vorlage (z. B. <#@template#>.). Er wird während der Kompilierung der Vorlage ausgeführt und kann Assemblys und andere Ressourcen laden. Er kann auch Code einfügen, mit dem Ressourcen zur Laufzeit geladen werden. Durch die Definition eines eigenen Anweisungsprozessors können Sie die Komplexität Ihrer Vorlagen verringern.

Aufruf der Texttransformation in einer VS-Erweiterung: Wenn Sie eine Visual Studio-Erweiterung schreiben, z. B. einen Menübefehl oder einen Ereignishandler, kann Ihre Erweiterung mit dem Textvorlagendienst eine beliebige Textvorlage transformieren. Sie können mithilfe des Sitzungsobjekts Parameterdaten an die Vorlage übergeben und die Werte innerhalb der Vorlage mit der Anweisung <#@parameter#> 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 Zustand der Anwendung. Beispielsweise kann der Host, der Texttransformationen in Visual Studio ausführt, Zugriff auf den Projektmappen-Explorer bereitstellen. Außerdem werden Fehler im Fehlermeldungsfenster angezeigt. Wenn Sie Texttransformationen in einem anderen Kontext ausführen möchten, können Sie einen eigenen Host definieren, der Zugriff auf die in diesem Kontext verfügbaren Dienste bietet.

Wenn Sie eine Visual Studio-Erweiterung schreiben, erwägen Sie die Verwendung des vorhandenen Texttransformationsdiensts, anstatt einen eigenen Host zu schreiben. Weitere Informationen finden Sie unter Aufrufen der Texttransformation in einer Visual Studio-Erweiterung.

Zugehöriger Inhalt