Anpassen der T4-Texttransformation

Textvorlagen sind eine Funktion von Visual Studio, die es Ihnen ermöglicht, Programmcode oder andere Textdateien mithilfe eines Transformationsprozesses zu generieren. Mit dem Visual Studio SDK können Sie den standardmäßigen Vorlagentransformationsprozess erweitern, indem Sie den Textvorlagen-Direktivenprozessor oder den Textvorlagenhost anpassen.

In diesem Abschnitt

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

• Erstellen von benutzerdefinierten Direktivenprozessoren für Textvorlagen
  Der Direktivenprozessor verarbeitet Direktiven in der 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, durch den Ressourcen zur Laufzeit geladen werden. Sie können die Komplexität der Vorlagen reduzieren, indem Sie einen eigenen Direktivenprozessor definieren.

• Aufrufen von Texttransformation in einer VS-Erweiterung
  Wenn Sie eine Visual Studio-Erweiterung schreiben, z. B. einen Menübefehl oder einen Ereignishandler, kann für die Erweiterung der Textvorlagendienst zum Transformieren beliebiger Textvorlagen verwendet werden. Sie können Parameterdaten mit dem Sitzungsobjekt an die Vorlage übergeben und die Werte von der Vorlage mithilfe der <#@parameter#>-Direktive abrufen.

• Verarbeiten von Textvorlagen mithilfe eines benutzerdefinierten Hosts
  Wenn der Code der Textvorlage ausgeführt wird, stellt der Host den Zugriff auf externe Dateien und den Zustand der Anwendung bereit. Der Host, der Texttransformationen in Visual Studio ausführt, kann z. B. Zugriff auf den Projektmappen-Explorer bieten. Er zeigt auch Fehler im Fehlermeldungsfenster an. 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, verwenden Sie ggf. den vorhandenen Texttransformationsdienst, anstatt einen eigenen Host zu schreiben. Weitere Informationen finden Sie unter Invoking Text Transformation in a VS Extension.

Referenz

Schreiben einer T4-Textvorlage

Enthält die Syntax von Textvorlagendirektiven und Kontrollblöcken.

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
Januar 2011	Aktualisiert, um den Textvorlagendienst zu erläutern	Informationsergänzung.