T4 Parameter Templates mit dynamischen Parametertypen

In meinen Projekten favorisiere ich mittlerweile den T4-Ansatz unter Verwendung von Parameter-Templates, die mit Hilfe von Metadaten für die Erstellung des Codes verantwortlich sind. Das Haupttemplate (Treiber) hat die Aufgabe die Daten aufzubereiten und ein Metadaten-Objekt an das Parameter-Template zu übergeben. Der Vorteil dieses Ansatzes, ich kann die aufbereiteten Metadaten dazu nutzen, um Konfigurations- und Codedateien zu erstellen, die Logik ist verständlicher, der Austausch ist einfacher und ich erspare mir Redundanzen, da Verarbeitung und Ausgabe getrennt sind. Mit diesem Ansatz eine WCF-Infrastruktur aufzubauen ist sehr praktisch ;-)

Bei kleineren Projekten finde ich es jedoch überdimensioniert, die typisierten Metaklassen in einer eigenen Assembly zu packen, sondern möchte diese im Class-Feature Block des Haupttemplates definieren.

Folgende Abbildung verdeutlicht dies:

: Abbildung 1 Haupttemplate mit der definierten Klasse für die Metadaten im Class-Feature Block

Die im Class-Feature Block definierte Klasse lässt sich jedoch nicht als Parameter-Typ verwenden. Der Versuch führt zu folgendem Fehler:

Kompilierte Transformation: Der Typ- oder Namespacename "MetadataObject" konnte im globalen Namespace nicht gefunden werden. (Fehlt ein Assemblyverweis?)

Aus diesem Grund ist der Umweg über eine eigene Assembly notwendig. Eine Alternative wäre aber auch der Einsatz des System.Object-Typs als Parameter und das Casting auf den Datentyp dynamic.

: Abbildung 2 Aufbau des Parameter Templates, damit die Klasse aus der Hauptvorlage verwendet werden kann.

Durch die späte Bindung wird der Aufruf der Eigenschaften ohne Fehlermeldung möglich. Der einzige Nachteil, man muss auf die IntelliSense verzichten, wenn man einen T4-Editor einsetzt. Zudem wird zusätzlich noch eine Referenz auf die Assembly Microsoft.CSharp.dll im Parameter Template benötigt.

Wird mit dieser Vorgehensweise das Haupttemplate ausgeführt, habe ich folgendes Ergebnis:

: Abbildung 3 Ausgabe des Quellcodes nach dem Speichern des Haupttemplates

Pragmatisch, praktisch, gut … ;-)

Die Klasse ParamTextTempalte befindet sich in der Include-Datei TemplateFileManager.CS.ttinclude. Der Inhalt steht in der Code-Gallery des Tangible T4-Editors unter der Kategorie .ttinclude zur Verfügung.